Skip to main content
La API de Fluz es un único endpoint de GraphQL por entorno. Esta página es la referencia complementaria de Cómo funciona la API GraphQL.

Explorar la referencia

Consultas

Operaciones de lectura: obtener billeteras, transacciones, comercios, ofertas de tarjetas y datos de cuenta.

Mutaciones

Operaciones de escritura: emitir tarjetas, mover dinero, registrar usuarios y negocios, y administrar aprobaciones.

Tipos

Objetos

Estructuras de respuesta devueltas por consultas y mutaciones.

Objetos de entrada

Argumentos que pasas a las operaciones.

Enums

Conjuntos fijos de valores permitidos, como estados y redes de tarjetas.

Uniones

Campos que se resuelven en uno de varios tipos de objeto.

Interfaces

Contratos de campos compartidos implementados por múltiples objetos.

Escalares

Valores primitivos como DateTime y UUID.

Convenciones

Autenticación

El encabezado Authorization, endpoints de tokens y la redirección de autorización de OAuth.

Errores

El sobre de error, prefijos de códigos de dominio y guía de reintentos.

Límites de velocidad

Límites de solicitudes por superficie y cómo se ve un 429.

Paginación

Entradas de desplazamiento, límites de tamaño de página y respuestas de conexión.

Endpoints REST

Una operación vive fuera de GraphQL: la carga de archivos utilizada para el registro de empresa unipersonal.

Endpoints

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

Encabezados

Sobre de respuesta

  • data: la carga útil exitosa (puede ser parcial en caso de error).
  • errors: arreglo de fallas, cada una con code, message y path.

Esquema

Staging expone introspección para que puedas apuntar tus herramientas (Apollo Studio, GraphiQL, codegen) directamente. En live, solicita el SDL actual a tu equipo de cuenta.