Manejo de errores
Errores legibles por máquinas según RFC 9457.
Los errores usan el Content-Type application/problem+json. Decide cómo actuar según code y el estado HTTP. detail explica el error; errors puede incluir errores de campos con rutas separadas por puntos. request_id vincula tu solicitud con el registro del servidor.
{
"type": "https://developers.adlass.io/errors/insufficient_scope",
"title": "Insufficient scope",
"status": 403,
"code": "insufficient_scope",
"required_scope": "spaces:write",
"request_id": "req_…"
}| Estado | Acción |
|---|---|
| 400 | Revisa los parámetros y el Idempotency-Key |
| 401 | Revisa la clave, el entorno, el vencimiento y la revocación |
| 403 | Revisa los scopes y los permisos del usuario |
| 404 | El recurso o la ruta no está disponible |
| 409 | Resuelve el conflicto de la operación |
| 422 | No reutilices un Idempotency-Key para otra intención |
| 429 | Espera el tiempo de Retry-After |
| 5xx | Reintenta un número limitado de veces con la misma clave de idempotencia |
El enlace type abre la referencia del código de error concreto. No se exponen detalles internos del proveedor. Incluye request_id al solicitar soporte, nunca la clave API.