Límites de uso
El caudal se cuenta por clave, en una ventana de un minuto. El tope depende del plan de la cuenta: 60 peticiones por minuto en Gratuito, 600 en Pro.
Topes
| Plan | Peticiones por minuto |
|---|---|
| Gratuito | 60 |
| Pro | 600 |
Cabeceras
Cada respuesta lleva X-RateLimit-Limit y X-RateLimit-Remaining. Un 429 añade Retry-After, en segundos. Lea esas cabeceras en lugar de contar sus llamadas: el tope puede cambiar con el plan, en caliente.
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
Retry-After: 37
{ "error": { "code": "rate_limited",
"message": "Rate limit of 60 requests per minute exceeded." } }Por clave, no por cuenta
Dos integraciones de una misma cuenta no se estorban, y se puede identificar cuál consume. Es también lo que hace que revocar una clave desbocada beneficie de inmediato al resto de la cuenta.
Ante un 429
Espere los segundos que indique Retry-After y reintente. La ventana es fija: pasado ese plazo, el contador vuelve a cero.
Pagine con un limit alto en lugar de multiplicar páginas pequeñas: cien elementos cuestan una petición, no cien. Para una sincronización, llame a /v1/commissions con from situado en su última ejecución en lugar de releerlo todo.