Limite de requisições (429)

Status: 429 Too Many Requests · type: https://api.nobur.com.br/errors/rate-limit

Quando acontece

A credencial enviou mais requisições do que o limite da janela atual. Toda resposta informa o limite em X-RateLimit-Limit, o que resta em X-RateLimit-Remaining e quando a janela reinicia em X-RateLimit-Reset.

O que fazer

Espere os segundos indicados no header Retry-After antes de tentar de novo, e reduza o ritmo: acompanhe X-RateLimit-Remaining e, para cargas grandes, prefira as operações em lote. Não repita a requisição em seguida; cada tentativa conta para o limite.

Exemplo

HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1771156842

{
  "type": "https://api.nobur.com.br/errors/rate-limit",
  "title": "Rate Limit Exceeded",
  "status": 429,
  "detail": "Rate limit exceeded",
  "instance": "/public/v1/brokers",
  "code": "rate_limit.exceeded",
  "request_id": "req_abc123",
  "timestamp": "2026-02-15T12:00:00Z",
  "documentation_url": "https://docs.nobur.com.br/docs/api/erros/rate-limit"
}