Skip to main content
A quota depende do seu plano. Um pedido = 1 unidade, independentemente do número de linhas devolvidas. O contador é reposto no início de cada hora (UTC).

​
Acesso por plano

Alguns endpoints estão reservados aos planos superiores: Chamar um endpoint fora do seu plano devolve 403:
403

​
Cabeçalhos de quota

Cada resposta autenticada inclui:

​
Excesso (429)

Esgotada a quota, os pedidos devolvem 429 até à reposição:
429
O cabeçalho Retry-After indica os segundos até à reposição (início da hora seguinte, UTC).

​
Débito instantâneo: 50 pedidos / segundo

Além da quota horária, cada chave está limitada a 50 pedidos por segundo. Este limite protege a disponibilidade do serviço: sem ele, um único cliente poderia consumir a sua quota horária em segundos e saturar a API para todos. Acima disso, a resposta é 429 — sem consumir quota:
429
O cabeçalho Retry-After vale 1: o contador reinicia no segundo seguinte, ao contrário da quota horária que espera pelo início da hora. Na prática, distribua as suas chamadas em vez de enviar rajadas — 50 pedidos por segundo chegam bem para alimentar um modelo em tempo real.

​
Uma única ligação WebSocket por chave

O fluxo WebSocket (/ws, plano Sharp) aceita uma ligação simultânea por chave API. Cada socket recebe todo o fluxo: várias ligações com a mesma chave multiplicam a largura de banda sem acrescentar nada. Uma segunda ligação é recusada com o código de fecho 4409:
É a ligação nova que é recusada, nunca a existente: um fluxo já estabelecido não será cortado a favor de um duplicado — tipicamente um script reiniciado sem fechar o anterior. Se o seu cliente se desligou abruptamente, o lugar liberta-se quando o servidor fecha o socket, e voltar a ligar de imediato funciona. Precisa de vários fluxos em paralelo? Crie uma chave por processo na sua área de cliente.

​
Acompanhe o seu consumo

O consumo da hora em curso também é mostrado no seu espaço de cliente.