Errors¶
Response shape¶
La mayoria de errores siguen el formato FastAPI:
{ "detail": "..." }
Excepcion: snapshot y export pueden devolver 503 con body "truthful" cuando un territorio no esta cargado.
Codigos¶
| HTTP | Motivo tipico | Que hacer |
|---|---|---|
| 400 | parametros invalidos (territory_code, event_types, etc.) | corregir request |
| 401 | falta o es invalida X-API-Key / sesion admin |
revisar credenciales |
| 403 | scope por territorios o consumer pausado | pedir acceso o reconfigurar key |
| 404 | territorio desconocido (admin) | validar ES-XX |
| 429 | rate limit excedido | reintentar con backoff |
| 503 | territorio no cargado (not_loaded) |
reintentar mas tarde |
503 not_loaded (truthful)¶
Ejemplo:
{
"territory_code": "ES-MC",
"territory_status": "not_loaded",
"message": "Territory not loaded yet."
}
Request ID¶
Todas las respuestas incluyen:
X-Request-Id
Incluyelo al abrir un ticket o al reportar un error.