Docs
API

Limites

Quantas chamadas por minuto cada chave pode fazer.

Cada chave de API pode fazer 1.200 chamadas por minuto (janela fixa de 60 segundos).

Toda resposta traz quanto ainda sobra na janela atual, para você se regular antes de bater no limite:

HeaderO que diz
RateLimit-LimitChamadas permitidas na janela (1200).
RateLimit-RemainingQuantas ainda cabem nesta janela.
RateLimit-ResetSegundos até a janela virar e o contador zerar.

Com RateLimit-Remaining em 0, espere RateLimit-Reset segundos antes da próxima chamada. Passou do limite, a resposta é 429 rate_limited com o header Retry-After (o mesmo valor do RateLimit-Reset).

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/problem+json

Dicas:

  • Prefira webhooks a consultar a API em loop para saber se um pedido foi pago.
  • Em listas grandes, use limit=100 (paginação).
  • Corpo de requisição: até 1 MB (envio de imagem: até 2 MB de imagem em base64).