Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.indiqai.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Rate Limits

As tools autenticadas documentadas aqui usam o rate limit global da categoria public_api: 60 requisições por minuto por API Key para garantir estabilidade e uso justo.

​
Limites atuais

LimiteValor
Requisições por minuto60
Escopo do limitePor API Key
JanelaDeslizante (sliding window)
Rotas públicas complementares, como quests públicas e eventos de email, podem aplicar limites específicos adicionais.

​
Headers de resposta

Toda resposta inclui headers que indicam o estado do seu limite:
HeaderDescriçãoExemplo
X-RateLimit-LimitLimite máximo de requisições na janela60
X-RateLimit-RemainingRequisições restantes na janela atual45
X-RateLimit-ResetSegundos restantes até o reset da janela atual27

​
Exemplo de resposta com headers

HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 27

{ ... }

​
Resposta quando o limite é excedido

Quando exceder o limite, a API retorna 429 Too Many Requests: 
{
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "Você atingiu o limite de requisições. Por favor, aguarde 27 segundos antes de tentar novamente.",
  "retry_after_seconds": 27,
  "retry_after_message": "27 segundos"
}
Headers na resposta 429: 
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 27
Retry-After: 27

​
Boas práticas

Monitore os headers X-RateLimit-Remaining e Retry-After para evitar bloqueios desnecessários.
  1. Implemente retry com backoff exponencial: ao receber 429, aguarde o tempo indicado no header Retry-After
  2. Interprete X-RateLimit-Reset como segundos restantes: o valor atual não é timestamp Unix
  3. Cache respostas: dados que mudam pouco (produtos, recompensas) podem ser cacheados localmente
  4. Agrupe operações: em vez de consultar clientes um a um, use a listagem paginada
  5. Preserve idempotência em retries: nos 3 writes críticos, reutilize a mesma X-Idempotency-Key