Orbio
Base URL: https://api.orbioapi.com.br

Rate limit e backoff

Objetivo: evitar erros 429 e implementar retry seguro.

Headers retornados

As respostas podem incluir:

  • RateLimit-Policy: política no formato RPM;w=60;burst=100 (exemplo)
  • RateLimit: resumo (limit, remaining, reset)
  • RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset
  • Retry-After (apenas em 429)

Exemplo de 429

json
{
  "type": "https://orbioapi.com.br/problems/rate-limit",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Limite de requisições excedido.",
  "instance": "/v1/accounts/search",
  "code": "rate_limit_exceeded",
  "request_id": "req_01HX..."
}

Estratégia recomendada

  1. Leia Retry-After.
  2. Aguarde o tempo indicado.
  3. Refaça a requisição.

Pseudo‑código (JS):

js
if (res.status === 429) {
  const retryAfter = Number(res.headers.get("Retry-After") || 1);
  await sleep(retryAfter * 1000);
  // retry
}

Verificação

  • RateLimit-Remaining diminui a cada requisição.
  • RateLimit-Reset indica segundos para o próximo ciclo.

Conceitos relacionados