Limites de requisição
Saiba quanto esperar antes de repetir uma chamada recusada por excesso de requisições e em quais rotas as chamadas são contadas por IP.
Onde vale
O limite vale para a geração de token de cartão e para as rotas do Checkout, contado pelo IP de origem da chamada:
| Rotas | Limite por IP |
|---|---|
| POST /v1/card-tokens | 10 chamadas por minuto |
| POST /v1/checkout/subscriptions | 10 chamadas por minuto |
| POST /v1/checkout/invoices/:invoice_id/payments POST /v1/checkout/payment-links/:payment_link_id/invoices | 10 chamadas por minuto, somadas as duas rotas |
| GET /v1/checkout/plans/:plan_id GET /v1/checkout/subscriptions/:subscription_id GET /v1/checkout/payment-links/:payment_link_id GET /v1/checkout/invoices/:invoice_id | 60 chamadas por minuto, somadas as consultas |
Cada linha da tabela tem o próprio contador. A contagem começa na primeira chamada e zera 60 segundos depois.
Gere o token de cartão no aparelho do comprador.
O IP contado é o de quem chama, então as chamadas que saem do seu servidor somam todas no IP dele.
Como ler o 429
A chamada acima do limite recebe 429, sem code e sem tempo de espera:
{
"status_code": 429,
"error": "too_many_requests",
"message": "Muitas tentativas. Aguarde um minuto.",
"request_id": "a1b2c3d4-0000-4000-8000-000000000000"
}Espere um minuto e só então repita a chamada. A chamada recusada com 429 não chega a ser processada, então a repetição não cria assinatura, fatura nem tentativa de pagamento em dobro.