Límite de Solicitudes
Cuando un cliente excede el límite asociado a él, las solicitudes siguientes se bloquean.
El servidor responde con información sobre los límites utilizados y el tiempo de espera necesario para enviar una nueva solicitud, adjuntas a los headers de la respuesta:
| Header | Ejemplo | Descripción |
|---|---|---|
ratelimit-limit | 60 | Límite de solicitudes para el cliente. |
ratelimit-name | throttle_authenticated_web | Nombre del throttle utilizado. |
ratelimit-remaining | 0 | Número de solicitudes disponibles. |
ratelimit-reset | 1609844400 | Unix time — cuándo se reinicia el conteo. |
retry-after | 30 | Segundos hasta que se reinicie el conteo. Ver Retry-After. |
Existen dos tipos de límites: solicitudes GET y solicitudes POST. En ambos casos el conteo se hace por hora.
Límites máximos:
- 60 solicitudes/hora para
GET - 1000 solicitudes/hora para
POST
Si tu operación necesita un número mayor, habla con soporte o con el área comercial.
El conteo se reinicia en el primer minuto de cada hora. En cada solicitud, el servidor devuelve ratelimit-limit y ratelimit-remaining.
Ejemplo de respuesta exitosa
Date: Fri, 05 Nov 2010 12:00:00 GMT
Content-Type: application/json; charset=utf-8
ratelimit-limit: 1000
ratelimit-remaining: 486
Ejemplo de respuesta con bloqueo
Cuando se alcanza el límite, el servidor devuelve HTTP 429 Too Many Requests. Espera el número de segundos del header retry-after antes de la siguiente solicitud.
HTTP/1.1 429 Too Many Requests
Date: Fri, 05 Nov 2010 12:00:00 GMT
Content-Type: application/json; charset=utf-8
ratelimit-limit: 1000
ratelimit-remaining: 0
ratelimit-reset: 3600
ratelimit-name: throttle_authenticated_web
retry-after: 3600
{"error": "Limite de requisições POST por hora excedido para esse usuário."}
Referência: https://ietf-wg-httpapi.github.io/ratelimit-headers/draft-ietf-httpapi-ratelimit-headers.html