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.
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:
{
"success": true,
"data": {}
}
Error:
{
"success": false,
"error": {
"code": "6010",
"name": "<nombre del catálogo>",
"description": "<descripción del catálogo>",
"message": "Missing user data"
},
"data": {}
}
code/name/descriptionprovienen del catálogo de errores (MongoDB).messagees 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.