Skip to main content

​
Overview

Cada API key tiene una quota de uso que define cuántas solicitudes puedes realizar en un periodo de tiempo. La quota protege la estabilidad del servicio y se asigna según tu plan.

​
Consulta tu quota en cada respuesta

No necesitas adivinar cuánta quota te queda: cada respuesta de la API incluye dos cabeceras (headers) que te dicen, en ese momento exacto, cuál es tu límite y cuánto has consumido. Vienen siempre, en todas las solicitudes, tengan o no éxito. Para saber cuántas solicitudes ya consumiste, basta con restar una de la otra:

​
Ejemplo

Si una respuesta trae estas cabeceras:
Significa que tu plan incluye 1000 solicitudes, te quedan 720 disponibles y ya has consumido 280.
Lee X-Quota-Remaining en tus respuestas para anticiparte: cuando se acerque a cero, podrás reducir el ritmo o avisar a tu equipo antes de recibir un 429.

​
Límite de solicitudes

Cuando superas el número de solicitudes permitido, la API responde con el código HTTP 429:
Los valores exactos de tu quota dependen del plan contratado. Escríbenos a soporte@verifica.id para conocer o ampliar los límites de tu API key.

​
Recomendaciones

  • Controla el ritmo de tus solicitudes para no agotar la quota en ráfagas cortas.
  • Implementa reintentos con backoff exponencial cuando recibas un 429, en lugar de reintentar de inmediato.
  • Cachea las respuestas que no cambian con frecuencia para reducir el consumo.