Ir al contenido principal
API para mentores

Errores

Formato uniforme de errores y códigos HTTP de la API para mentores.

Escrito por Jacobo

Última actualización Hace 23 días

Todos los errores tienen la misma forma:

{
  "error": "validation_failed",
  "category": "validation",
  "message": "El taller requiere fecha de inicio",
  "issues": [
    { "path": "content.start_date", "message": "required" }
  ]
}

CampoDescripción
errorCódigo estable, apto para lógica en tu código
categorypermission, validation, state o internal
messageDescripción legible
issuesOpcional: lista de campos con problema (path + message)

Códigos HTTP

HTTPCategoríaEjemplo
400validationJSON mal formado (invalid_json); campo faltante o inválido, campo desconocido o id de contenido ajeno (validation_failed)
401permissionFalta la API Key (unauthorized) o es inválida o fue revocada (invalid_api_key)
404stateEl recurso no existe, no es tuyo o no corresponde al tipo de la ruta (not_found)
422validationEl request es válido pero una regla del producto lo impide: falta algo para publicar, slug ya usado, coproducción inválida… (unprocessable)
500internalError inesperado de nuestro lado (internal_error); puedes reintentar

Consejo: usa error y category para decidir qué hacer en tu integración, y message / issues para mostrarle el problema a una persona.