Manejo de Errores

Formato de Respuesta de Error

{
  "error": "Geocoding service error",
  "message": "Detailed error description"
}

Codigo	Significado	Causas Comunes
`400`	Bad Request	Campos requeridos faltantes, parametros invalidos
`401`	Unauthorized	Encabezado `X-API-Key` faltante
`403`	Forbidden	Clave API invalida/expirada, dominio o IP bloqueada, endpoint deshabilitado, cuota excedida
`429`	Too Many Requests	Limite de tasa excedido (por minuto o por dia)
`500`	Internal Server Error	Falla en la API del proveedor, error inesperado

Los limites de tasa se aplican por clave API:

Cuando se excede el limite de tasa, el cuerpo de la respuesta incluye el limite que fue excedido:

{
  "detail": "Rate limit exceeded: 100 requests per minute"
}

Cada cliente tiene cuotas por endpoint que se reinician diaria o mensualmente:

{
  "detail": "Quota exceeded for geocode endpoint"
}

Consulta tu uso actual de cuota a traves del endpoint de Uso.

Si un endpoint especifico no esta habilitado para tu cuenta:

{
  "detail": "The geocode endpoint is not enabled for your account"
}

Contacta a tu administrador para habilitar el endpoint.

Si el proveedor de geocodificacion subyacente falla, recibiras una respuesta 500:

{
  "error": "Geocoding service error",
  "message": "LocationIQ API request failed: 429 Client Error: Too Many Requests"
}

Estos son errores transitorios: reintenta despues de una breve pausa.