Saltar al contenido
ecuadorapi
Obtener API key

Primeros pasos

Errores y límites

Identifica una respuesta de error y sabe cuándo reintentar.

Si una consulta falla

Revisa el estado HTTP y el mensaje de la respuesta. Los errores no descuentan saldo.
Ejemplo de errorjson
{
  "data": null,
  "error": true,
  "message": "Has excedido el límite de solicitudes.",
  "code": "throttled"
}

Manejo de errores por lenguaje

Los ejemplos del inicio rápido muestran una consulta exitosa. Usa estas versiones para controlar errores y tiempos de espera en tu integración.
Solicitud cURLbash
curl "https://api.ecuadorapi.com/api/v1/cedulas/1700000000/nombres" \
  -H "Authorization: Bearer $ECUADORAPI_KEY" \
  --fail-with-body \
  --max-time 60

Ejecuta desde tu terminal. Configura ECUADORAPI_KEY en el entorno. Nunca publiques tu clave en el navegador.

Los ejemplos de JavaScript, Python y PHP validan el estado HTTP y el campo error antes de usar data. Captura también los errores de conexión en tu aplicación. cURL muestra la respuesta y devuelve un código de salida de error si falla la petición HTTP.

Límite de peticiones

El límite depende de tu cuenta. Puedes consultarlo en el dashboard.
X-RateLimit-Limit
Máximo de peticiones por minuto.
X-RateLimit-Remaining
Peticiones disponibles en la ventana actual.
Retry-After
En una respuesta 429, segundos que debes esperar antes de reintentar.