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

* O Starter não concede acesso à API. Chamadas desse plano são recusadas com 403, e os contadores acima só existem para a proteção de origem. Limites acima do Pro existem apenas em contrato negociado, ajustados conta a conta.

Os contadores são compartilhados entre a API REST e o servidor MCP. Um relatório pedido pela IA e uma chamada GET /api/v1/contacts gastam do mesmo teto.

Por quanto tempo guardamos o registro

Passado esse prazo a linha é apagada de vez. Se a sua auditoria precisa de prazo maior, guarde no seu lado no momento em que a chamada acontece.

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.

Veja também

• Limites do MCP, com o peso por ferramenta e o intervalo mínimo.
• Integrações, a explicação sem jargão da mesma tela, com prints.