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 Requestscom o headerRetry-After(em segundos) etypehttps://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+jsonRequisiçã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=100e filtros de data em vez de muitas páginas pequenas. - Precisa de mais? Fale com a gente pelo Atendimento.