07 - Errores y validaciones

Los endpoints de la API devuelven JSON cuando hay errores, salvo descargas binarias que fallen antes de emitir el archivo.

Códigos HTTP habituales

Código	Significado	Qué revisar
`400`	Petición inválida	Campos, formato del body, fechas o tipos de datos.
`401`	No autenticado	Cabecera `Token` ausente, incorrecta o desactivada.
`403`	Sin permiso	La API Key no puede acceder a ese recurso u operación.
`404`	No encontrado	Recurso, registro o endpoint inexistente.
`409`	Conflicto	Duplicados, restricciones únicas o estado incompatible.
`422`	Validación de modelo	Falta un campo obligatorio o no cumple reglas de negocio.
`500`	Error interno	Reintentar con trazabilidad y contactar soporte si persiste.

{
  "error": "Mensaje legible del error",
  "code": "VALIDATION_ERROR",
  "details": {
    "campo": "descripcion del problema"
  }
}

Registra endpoint, método y código HTTP.
No registres API Keys ni datos sensibles en logs.
Trata 401 y 403 como problemas de configuración o permisos.
Trata 400 y 422 como errores corregibles de payload.
Implementa reintentos solo para errores temporales o de red, no para validaciones.

Habla con nuestro equipo y te resolvemos cualquier duda al instante.