Saltar al contenido principal
Migo Docs

Autenticación

Todos los endpoints de negocio de Créditos Core requieren el header Authorization, validado por un TOKEN Authorizer en API Gateway. Los webhooks (callbacks de banco/colector) y los eventos internos (EventBridge/SNS) son las únicas excepciones.

Header requerido​

Authorization: <token>

El valor es el token emitido por Migo. El authorizer rechaza cualquier petición sin un token válido antes de que llegue al servicio.

Webhooks sin authorizer

Los endpoints bajo v2/credits/webhooks/... que reciben callbacks del banco, del colector o de EventBridge no pasan por el TOKEN Authorizer. Ver Webhooks y notificaciones.

Formato universal de respuesta​

Todas las respuestas comparten el mismo envelope.

Éxito — HTTP 200:

Respuesta exitosa
{
"success": true,
"data": {}
}

Error:

Respuesta de error
{
"success": false,
"error": {
"code": "6010",
"name": "<nombre del catálogo>",
"description": "<descripción del catálogo>",
"message": "Missing user data"
},
"data": {}
}
  • code / name / description provienen del catálogo de errores (MongoDB).
  • message es el detalle específico que agrega el servicio.
  • El status HTTP lo define el servicio (400 / 401 / 403 / 404 / 409 / 500).

El catálogo completo de códigos y la estrategia de reintento están en Catálogo de errores.

Probar en el navegador​

La referencia interactiva de Créditos Core renderiza todos los endpoints con Scalar. Configura el header Authorization una vez y todos los endpoints autenticados lo reutilizan.