Atendimento

Rate limit

Quantas requisições por minuto e como tratar o 429.

Cada client pode fazer até 60 requisições por minuto. A cota é reabastecida aos poucos ao longo do minuto, não toda de uma vez: depois de uma rajada, as requisições voltam a passar em poucos segundos.

  • Toda resposta de sucesso traz o header RateLimit-Remaining, com quantas requisições ainda cabem agora.
  • Ao exceder, a API responde 429 Too Many Requests com o header Retry-After (em segundos) e type https://u2d.com.br/problemas/limite-requisicoes. Espere esse tempo antes de tentar de novo.
HTTP/1.1 429 Too Many Requests
Retry-After: 2
Content-Type: application/problem+json

Requisição barrada pelo limite não chega a ser processada. Numa emissão, repita depois com a mesma Idempotency-Key: ela ainda não foi usada.

As rotas sem autenticação (GET /api/v1/status-servico e GET /public/status) têm limite próprio, por IP.

Boas práticas

  • Reaproveite o access token por 5 minutos em vez de pedir um por chamada.
  • Acompanhe as notas pelo webhook em vez de consultar cada uma em loop.
  • Na sincronização, use tamanho=100 e filtros de data em vez de muitas páginas pequenas.
  • Precisa de mais? Fale com a gente pelo Atendimento.

Nesta página