​
Visión general

Todas las respuestas de error del API de Trébol siguen una estructura consistente para que puedas detectarlas y manejarlas de forma predecible en tu cliente.

​
Formato de respuesta de error

{
  "success": false,
  "message": "Descripción breve y accionable del error",
  "code": "CODIGO_ESTATICO",
  "timestamp": "2025-01-01T12:34:56.000Z"
}
  • “success”: siempre es false en los errores.
  • “message”: mensaje legible para humanos. No dependas únicamente de este texto para lógica.
  • “code”: identificador estable para programar flujos de manejo de errores.
  • “timestamp”: ISO 8601, útil para trazabilidad.
Programa tus clientes en función de code y del HTTP status, no del texto de message.

​
Códigos y estados HTTP

Código (code)HTTP statusCuándo ocurre
VALIDATION_ERROR400Datos inválidos o faltantes en la solicitud.
BAD_REQUEST400Solicitud mal formada (p.ej., parámetros requeridos ausentes).
UNAUTHORIZED401Falta autenticación o credenciales inválidas.
FORBIDDEN403Usuario autenticado sin permisos para la acción.
NOT_FOUND404Recurso no existe. Incluye compat. con err_record_not_found.
CONFLICT409Conflicto de estado.
DUPLICATE_RESOURCE409Intento de crear un recurso que ya existe.
INTERNAL_SERVER_ERROR500Error inesperado en el servidor.