Límite de solicitudes
Existen dos tipos de límites — solicitudes GET y solicitudes POST —, ambos contados por hora, con el conteo reiniciado en el primer minuto de cada hora:
| Tipo | Límite |
|---|---|
GET | 60 solicitudes/hora |
POST | 1000 solicitudes/hora |
Si tu operación necesita un número mayor, habla con el soporte o el área comercial.
Headers de respuesta
En cada solicitud, el servidor adjunta a los encabezados de la respuesta los límites utilizados y el tiempo de espera hasta la próxima ventana:
| Header | Ejemplo | Descripción |
|---|---|---|
ratelimit-limit | 60 | Límite de solicitudes para el cliente. |
ratelimit-name | throttle_v1_write | Nombre del throttle utilizado. |
ratelimit-remaining | 0 | Número de solicitudes disponibles. |
ratelimit-reset | 1782648000 | Unix time — cuándo se reinicia el conteo. |
retry-after | 30 | Segundos hasta que el conteo se reinicie. Ver Retry-After. |
Ejemplo de respuesta en éxito
Date: Fri, 17 Jul 2026 12:00:00 GMT
Content-Type: application/json; charset=utf-8
ratelimit-limit: 1000
ratelimit-remaining: 486
Ejemplo de respuesta en 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 próxima solicitud.
HTTP/1.1 429 Too Many Requests
Date: Fri, 17 Jul 2026 12:00:00 GMT
Content-Type: application/json; charset=utf-8
ratelimit-limit: 1000
ratelimit-remaining: 0
ratelimit-reset: 3600
ratelimit-name: throttle_v1_write
retry-after: 3600
{ "error": { "code": "rate_limited", "message": "Write request rate limit exceeded for this token." } }
tip
Referencia: RateLimit header fields for HTTP