Límite de solicitudes
Existen dos tipos de límites — solicitudes de lectura (GET) y de escritura (POST, PUT, PATCH, DELETE) —, ambos por ventana deslizante de 1 hora: cada solicitud cuenta contra el límite durante los 60 minutos siguientes; no hay un reinicio a hora fija.
| Tipo | Límite |
|---|---|
Lectura (GET) | 60 solicitudes/hora |
Escritura (POST, PUT, PATCH, DELETE) | 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 cuándo se libera el conteo:
| 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: 1784293200
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