Errores

Formato de respuesta

Todos los errores devuelven un cuerpo JSON:

{
  "error": {
    "code": "validation_failed",
    "message": "The given data was invalid.",
    "details": {
      "email": ["The email has already been taken."]
    }
  },
  "request_id": "req_01HXXXXXX"
}

Siempre incluya el request_id cuando contacte con soporte sobre un error.

Códigos de estado HTTP

Estado	Significado
200 OK	Éxito
201 Created	Recurso creado
400 Bad Request	Solicitud mal formada
401 Unauthorized	Token faltante o inválido
403 Forbidden	Token válido pero permisos insuficientes
404 Not Found	Recurso no encontrado
409 Conflict	Conflicto (por ejemplo, correo electrónico ya registrado)
422 Unprocessable Entity	Validación fallida
429 Too Many Requests	Límite de velocidad excedido
500 Internal Server Error	Error del servidor

Códigos de error

Código	Descripción
validation_failed	El cuerpo de la solicitud no pasó la validación
unauthorized	Token faltante o expirado
forbidden	El token carece del alcance requerido
not_found	El recurso no existe
conflict	Violación de restricción única
rate_limited	Demasiadas solicitudes
internal_error	Error inesperado del servidor