EN

Errores

Todos los errores — incluidos los producidos en el borde — comparten un mismo envelope JSON. El campo code es estable y seguro para programar contra él; detail es legible para humanos y puede cambiar.

{
  "type": "about:blank",
  "title": "UNAUTHORIZED",
  "status": 401,
  "code": "unauthorized",
  "detail": "Unauthorized",
  "request_id": "9739dd78-..."
}
StatuscodeSignificado
401unauthorizedAPI key ausente, mal formada o desconocida
403access_deniedKey revocada/expirada, plan faltante, IP no permitida, o recurso fuera de tus permisos
404El recurso no existe
400bad_requestParámetros inválidos (p. ej. cursor malo)
422Error de validación; el cuerpo lista los campos con problema
429rate_limited / quota_exceededVer Límites
5xxserver_errorDe nuestro lado — reintenta con retroceso; incluye el request_id al contactar soporte
Siempre registra el request_id: le permite a nuestro equipo de soporte encontrar tu request exacto.