Saltar al contenido principal

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:

HeaderEjemploDescripción
ratelimit-limit60Límite de solicitudes para el cliente.
ratelimit-namethrottle_authenticated_webNombre del throttle utilizado.
ratelimit-remaining0Número de solicitudes disponibles.
ratelimit-reset1609844400Unix time — cuándo se reinicia el conteo.
retry-after30Segundos 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