Skip to main content

Os limites

O limite geral é somado entre todos os endpoints. Não existe cota separada por recurso.

Headers

Toda resposta traz os headers padrão, então dá pra desacelerar antes de bater no teto:

Quando estoura

Não faça retry imediato de um 429. Você continua bloqueado até a janela virar, e cada tentativa só empurra o problema pra frente.
Espere pelo menos o RateLimit-Reset, e use backoff exponencial com jitter:
O jitter não é enfeite: sem ele, todos os seus workers acordam no mesmo instante e batem no limite de novo, juntos.

O jeito de não chegar perto

Use webhook em vez de polling

É de longe a maior economia. Uma cobrança consultada a cada 3 segundos por 30 minutos são 600 requisições. O webhook resolve em uma.

Se precisar consultar, espace

Intervalo de 5 segundos ou mais, e pare no primeiro status final (paid, expired, refunded).

Pagine com limite alto

As listagens aceitam limit até 100. Buscar de 10 em 10 gasta 10 vezes mais requisição pelo mesmo resultado.

Cacheie o que não muda

Catálogo de produto não precisa ser relido a cada request do seu usuário.
Se você tem vários serviços integrando, dê uma chave para cada um. Assim o limite de saque de um job não é consumido pelo checkout, e você descobre rápido qual serviço está gastando requisição à toa.