atrusDocs
Guía de integración›Convenciones›Límite por llave

Límite por llave

Cada llave puede hacer hasta 120 peticiones por minuto. Toda respuesta trae tres cabeceras para que tu cliente se regule solo:

CabeceraQué dice
X-RateLimit-LimitEl tope por minuto de esta llave.
X-RateLimit-RemainingCuántas peticiones quedan en la ventana actual.
X-RateLimit-ResetSegundos hasta que la ventana se reinicia.

Al pasarse, la respuesta es 429 rate_limited con Retry-After en segundos. Espera eso y sigue; no hace falta más.

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 37
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 37

Si necesitas más

Pide páginas de 100 en vez de 50, guarda lo que ya leíste y reparte el trabajo entre llaves distintas sólo si son integraciones distintas. Si aun así el tope queda corto, escríbenos: el límite es por llave y se puede subir.