Formato de errores
Códigos de error HTTP y el formato de fallos de negocio.
Cualquier error de request (no de negocio — ver cada endpoint para sus propios códigos internos) devuelve uno de estos tres formatos:
| Status | Cuándo | Body |
|---|---|---|
400 | Falta un parámetro requerido o tiene un tipo/valor inválido | { "error": "bad_request", "message": "..." } |
401 | Falta el header Authorization, o la key es inválida/fue eliminada | { "error": "unauthorized" } |
500 | Error inesperado del servidor | { "error": "internal_error", "message": "Internal server error" } |
Los fallos de negocio (créditos insuficientes, urn no encontrado, etc.) no son errores HTTP — el request devuelve 200 con success: false y un code explicando qué pasó. Están documentados en cada endpoint.