Limites de requisições & créditos
O que é limitado
Seu plano limita quatro coisas, todas visíveis em GET /v1/account: contas monitoradas, palavras-chave, conexões WebSocket simultâneas e requisições por minuto. As duas primeiras retornam 402 plan_limit com details.resource, a terceira fecha o socket com 4002, a quarta retorna 429 rate_limited com um cabeçalho Retry-After.
Cabeçalho
Toda resposta autenticada informa onde você está, para que um cliente possa recuar antes de ser recusado:
| Cabeçalho | Significado |
|---|---|
X-RateLimit-Limit | Requisições permitidas por minuto para esta chave |
X-RateLimit-Remaining | O que resta no minuto atual |
X-RateLimit-Reset | Hora Unix em que a janela é reiniciada |
X-Credits-Used-Today | Créditos consumidos por leituras sob demanda desde 00:00 UTC |
X-Request-Id | Cite-o e conseguimos localizar a requisição exata nos nossos logs |
X-Response-Time | Quanto tempo levamos, em milissegundos |
ETag | Validador fraco de uma resposta JSON; envie-o de volta como If-None-Match |
Idempotent-Replay | true quando a resposta é uma repetição de uma requisição anterior com a mesma Idempotency-Key |
Retry-After | Segundos a esperar, em todo 429 |
Location | Onde está o recurso criado ou enfileirado, em 201 e 202 |
Créditos
O streaming não é medido — uma conexão ociosa e uma ocupada custam o mesmo, e os frames no socket não contam contra o orçamento de requisições. As leituras REST sob demanda em Leituras consomem créditos, um ou dois por chamada conforme indicado em cada endpoint; GET /v1/account/usage mostra seus totais diários.