Sección 04

Configuración de la conexión

Credenciales y autenticación JWT.

Configuración de la conexión#

Integración de credenciales en la aplicación#

Integra el Project ID y la API Key en el backend de tu plataforma. Guárdalos como secretos del servidor: nunca los expongas en el navegador ni en aplicaciones cliente.

Autenticación en la Aggregator API#

Para acceder a los endpoints protegidos de la Aggregator API debes generar un JSON Web Token (JWT) con tus credenciales:

POST{{URL_AGG}}/casino-auth/login

AuthSin autenticación

Ejemplo de solicitud

curl -X POST "{{URL_AGG}}/casino-auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "projectId",
    "apikey": "apiKey"
  }'

Respuesta exitosa

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Body de la solicitud

Parámetro	Tipo	Requerido	Descripción
projectId	string	Sí	Project ID asignado por AIC a tu proyecto.
apikey	string	Sí	API Key de tu proyecto. Manténla confidencial.

Campos de respuesta

Parámetro	Tipo	Descripción
access_token	string	JWT que debes enviar como Bearer Token en el encabezado Authorization de los endpoints protegidos.

Nota

Si el Project ID o la API Key no son válidos, la API responde HTTP 403.

Uso y renovación del token#

Envía el token en cada endpoint protegido con el encabezado Authorization: Bearer <access_token>.
El token tiene una vigencia de 24 horas. Renuévalo antes de que venza volviendo a llamar a login con tus credenciales.
Algunas respuestas incluyen un campo token; no necesitas usarlo. Tu sesión se gestiona con el access_token de login.