Limites de requisições

Cada conta tem um único conjunto de contadores, compartilhado por todas as suas chaves. As três janelas são avaliadas em toda chamada autenticada, inclusive quando a resposta é um erro 4xx.

Limites por plano

* Os valores de Starter e Demo são defaults internos do limitador compartilhado e não concedem acesso à API. Chamadas com esses planos são bloqueadas pelo gate de plano. Enterprise é uma configuração Pro com limites individuais.

Headers de resposta

Toda resposta autenticada informa a janela mais restritiva naquele momento:

Quando qualquer janela estoura, a API responde 429 rate_limited. O texto informa se o limite atingido foi por minuto, hora ou dia. Uma falha de autenticação 401 não consome o limite da conta e usa uma proteção separada por IP.

Conferir headers com curl

Use --include para exibir status e headers:

curl --include \
  --request GET \
  --url "https://api.octosolve.com.br/api/v1/contacts?limit=1" \
  --header "Authorization: Bearer osk_live_exemplo_ficticio_00000000000000000000000000" \
  --header "Accept: application/json"

Receita para Make ou n8n

1. Ative a opção de retornar status e headers completos no módulo ou nó HTTP.
2. Depois de cada chamada, leia x-ratelimit-remaining e x-ratelimit-reset.
3. Se o status for 429, aguarde o número de segundos de retry-after.
4. No Make, use Sleep antes de repetir o módulo. No n8n, use Wait e conecte novamente ao nó HTTP.
5. Não repita imediatamente em loop. Se o header não estiver disponível, aplique espera crescente com um teto seguro.
6. Distribua importações grandes ao longo do dia para respeitar também as janelas de hora e dia.