Skip to main content
Fluz expone un único endpoint de GraphQL por entorno. No hay URLs base por capacidad: envías una consulta o mutación a /api/v1/graphql, y el token decide en qué cuenta estás operando.

​
Endpoints

Los tokens de acceso se emiten en el mismo endpoint mediante la mutación generateUserAccessToken, autorizada con tu API Key — consulta Autenticación.

​
Anatomía de una solicitud

  • query — el documento GraphQL. Usa operaciones con nombre (query GetWallet) para mejores registros.
  • variables — entradas tipadas, que mantienen los valores fuera de la cadena de consulta.
  • operationName — opcional, útil cuando un documento define múltiples operaciones.

​
Consultas vs. mutaciones

  • Consultas son de solo lectura (viewer, wallet, transactions).
  • Mutaciones cambian el estado (createVirtualCard, purchaseGiftCard, depositCashBalance, createTransfer).
Las mutaciones que mueven dinero usan desduplicación de solicitudes — consulta Idempotencia.

​
Formato de respuesta

GraphQL siempre devuelve HTTP 200 con un contenedor data / errors:
En caso de fallo, data puede ser null y errors describirá qué salió mal — incluyendo un code legible por máquina sobre el que puedes bifurcar. Consulta Errores.

​
Introspección y esquema

La introspección está habilitada en staging para que puedas apuntar herramientas como Apollo Studio o GraphiQL al endpoint. En live, la introspección está deshabilitada; usa el esquema publicado en la Referencia de la API.

​
Próximos pasos

Autenticación

Cómo se emite el token en ese encabezado Authorization: para tu cuenta o la de un cliente.

Errores

Qué contiene el arreglo errors y cómo bifurcar según los códigos de error.