Códigos de error

La API utiliza códigos de estado HTTP estándar y devuelve respuestas de error en formato JSON.

Códigos de estado HTTP

Código	Significado	Descripción
200	OK	Solicitud exitosa
400	Bad Request	Parámetros ausentes o inválidos
401	Unauthorized	API key ausente o inválida
403	Forbidden	La API key no tiene acceso
404	Not Found	El endpoint no existe
429	Too Many Requests	Límite de tasa o cuota excedidos
500	Internal Server Error	Algo salió mal en nuestro lado
503	Service Unavailable	Servicio dependiente temporalmente no disponible

Formato de respuesta de error

Todas las respuestas de error siguen un formato consistente:

{
  "error": "Description of the error",
  "status": 400
}

Errores comunes

API Key ausente

curl https://api.iqxlookup.neivi.es/api/v1/email?address=test@example.com

{
  "error": "Missing X-Api-Key header",
  "status": 401
}

Parámetros inválidos

curl -H "X-Api-Key: ALk-your-key" \
  "https://api.iqxlookup.neivi.es/api/v1/email"

{
  "error": "Parameter 'address' is required",
  "status": 400
}

Límite de tasa excedido

{
  "error": "Rate limit exceeded",
  "retryAfter": 42,
  "status": 429
}