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"
}

Incluya siempre el request_id al contactar 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 (p. ej., correo electrónico ya tomado)
422 Unprocessable Entity	Validación fallida
429 Too Many Requests	Límite de tasa excedido
500 Internal Server Error	Error del lado 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