Menu da documentação

rate_limited

HTTP 429 · Limite de requisições excedido


HTTP	`429`
`title`	Limite de requisições excedido
`detail`	Sem `detail`

Quando acontece: o tenant passou do limite por minuto do plano (standard 600, premium 3.000; valores provisórios). O limite é do tenant inteiro, somando todos os clients e rotas.

O que fazer: espere os segundos do header Retry-After e repita. Acompanhe X-RateLimit-Remaining para não chegar no limite. Não faça polling de status: use os webhooks. A requisição barrada não reservou a Idempotency-Key, então pode repetir com a mesma.

Exemplo da resposta

application/problem+json

{
    "type": "https://sandbox.pagaki.com.br/errors/rate_limited",
    "title": "Limite de requisições excedido",
    "status": 429,
    "code": "rate_limited",
    "request_id": "01JBZ3Q2W5E8R1T4Y7K0M3N6P9"
}

Decida pelo code, que é estável; o detail pode mudar de texto. Guarde o request_id para falar com o suporte. Todos os erros.