Catálogo de errores
Toda respuesta de error usa el formato application/problem+json (RFC 9457).
El campo type apunta a la página de este catálogo correspondiente a su code:
https://docs.skipo.com/errors/{code}. El code es un contrato estable —
ramifica tu lógica sobre él.
code | HTTP | ¿Reintentable? | Título |
|---|---|---|---|
validation_error | 400 | no | Validation error |
unauthorized | 401 | no | Unauthorized |
invalid_signature | 401 | no | Invalid signature |
clock_skew | 401 | sí | Clock skew too large |
nonce_reused | 401 | sí | Nonce already used |
key_expired | 401 | no | API key expired |
key_revoked | 401 | no | API key revoked |
insufficient_scope | 403 | no | Insufficient scope |
ip_not_allowed | 403 | no | IP address not allowed |
two_factor_required | 403 | no | Two-factor required |
permission_denied | 403 | no | Permission denied |
api_access_disabled | 403 | no | API access disabled |
not_found | 404 | no | Resource not found |
conflict | 409 | no | Conflict |
idempotency_conflict | 409 | no | Idempotency conflict |
key_limit_reached | 409 | no | API key limit reached |
quotation_expired | 410 | sí | Quotation expired |
unprocessable | 422 | no | Unprocessable request |
rate_limited | 429 | sí | Rate limit exceeded |
internal_error | 500 | sí | Internal server error |
downstream_unavailable | 502 | sí | Downstream service unavailable |
maintenance | 503 | sí | Service under maintenance |
service_degraded | 503 | sí | Service degraded |