Skip to main content

Obtén tus credenciales de API

Una vez que tu aplicación esté creada en la Consola de Desarrolladores, selecciónala para encontrar su API Key, User ID y Account ID.
Dónde encontrarlas: la página de Desarrolladores, dentro de la aplicación que creaste. Estas credenciales habilitan la autorización por clave de API — principalmente llamadas administrativas y la generación de tokens de acceso de usuario.
Obtain API credentials Cada solicitud a la API de Fluz usa un token de acceso de usuario en el encabezado Authorization. Creas (mint) el token llamando la mutación generateUserAccessToken con tu API Key en el encabezado Authorization: Basic <API_KEY>, pasando el User ID y el Account ID desde la consola como argumentos.

Genera un token de acceso

La respuesta contiene el token de acceso y los alcances (scopes) que lleva:

Usa el token

Adjunta el token a cada solicitud GraphQL contra el grafo transaccional:
Nunca envíes tu clave de API a un navegador o cliente móvil. Genera (mint) tokens de acceso del lado del servidor y, si es necesario, reenvía solo el token al cliente.

Genera un nuevo token antes del vencimiento

Los tokens de acceso tienen corta duración. Genera uno nuevo antes de que el actual expire — no esperes a un 401. Consulta Reemplazar un token de acceso vencido para la llamada exacta, y Autenticación para el flujo completo, incluidos los grants de OAuth para tokens con alcance de cliente.

Próximos pasos

Inicio rápido: tu primera compra de tarjeta de regalo

Ejecuta el flujo exitoso de punta a punta — deposita fondos, compra una tarjeta de regalo y revélala en el sandbox.

Reemplazar un token vencido

Genera un token de acceso nuevo cuando expire el actual.