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.
| Cabecera | Qué te dice |
|---|
X-Quota-Limit | El total de solicitudes que incluye tu plan. |
X-Quota-Remaining | El número de solicitudes que aún te quedan por usar. |
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:
| Código | Significado |
|---|
429 | Demasiadas solicitudes — se ha excedido el límite de rate |
Los valores exactos de tu quota dependen del plan contratado. Escríbenos a [email protected] 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.
