Limites de taxa

A API Annie Insights impõe limites de taxa para garantir o uso justo e a estabilidade do sistema.

Limites por tipo de chave

Tipo de chave	Limite de taxa	Explodido	Limite diário
Caixa de areia	10 solicitações/min	5 simultâneos	500/dia
Produção	Personalizado	Personalizado	Personalizado

Cabeçalhos de limite de taxa

Cada resposta da API inclui informações de limite de taxa nos cabeçalhos:

Cabeçalho	Descrição
X-RateLimit-Limit	Máximo de solicitações permitidas na janela atual
X-RateLimit-Remaining	Solicitações restantes na janela atual
X-RateLimit-Reset	Carimbo de data e hora Unix quando a janela é redefinida
Retry-After	Segundos para esperar antes de tentar novamente (somente em 429)

Lidando com Limites de Taxa

Quando você excede o limite de taxa, a API retorna HTTP 429:

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Retry after 60 seconds.",
  "statusCode": 429
}

Melhores práticas

1. Monitore cabeçalhos — Verifique X-RateLimit-Remaining antes de enviar solicitações
2. Solicitações de fila — Implemente uma fila de solicitações com taxa de transferência controlada
3. Retirada exponencial — Em 429, espere 2^attempt segundos antes de tentar novamente
4. Entre em contato com vendas — Para limites mais altos, entre em contato com api-support@hcds.ai