Errores y códigos de respuesta

Códigos HTTP

La API usa códigos HTTP estándar para indicar el resultado de cada petición.

Código	Estado	Descripción
`200`	OK	Petición exitosa
`400`	Bad Request	Parámetros inválidos o faltantes
`401`	Unauthorized	Token inválido o no proporcionado
`403`	Forbidden	Sin permisos para este recurso
`404`	Not Found	Recurso no encontrado
`429`	Too Many Requests	Límite de consultas excedido
`500`	Internal Server Error	Error interno del servidor

Todos los errores retornan un JSON con la siguiente estructura:

{
  "success": false,
  "error": {
    "code": "INVALID_PARAM",
    "message": "El número de DNI debe tener 8 dígitos"
  }
}

Código	Descripción
`UNAUTHORIZED`	Token inválido o expirado
`MISSING_TOKEN`	No se envió el header Authorization
`FORBIDDEN`	Sin permisos para este recurso
`RATE_LIMIT`	Se excedió el límite de consultas
`INVALID_PARAM`	Parámetro con formato inválido
`NOT_FOUND`	El recurso consultado no existe
`INTERNAL_ERROR`	Error interno — contacta soporte

Los headers de respuesta incluyen información sobre tu uso:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1740000000

Si necesitas más consultas, considera actualizar tu plan en json.ricardofuentes.dev.