Limites de requisições

Cada conta pode fazer 30 chamadas de criação de links por janela de 60 segundos, compartilhadas entre REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets e MCP create_links. Cada reserva de envio e envio de planilha usa uma chamada; as conversões de links derivadas não usam nenhuma. Uma solicitação com resposta imediata e um envio em lote usam uma chamada cada, independentemente do número de entradas.

As solicitações de criação admitidas e as recusas por limite de requisições incluem cabeçalhos estruturados:

RateLimit-Policy: "create-links";q=30;w=60
RateLimit: "create-links";r=29;t=60

q é a cota e w é sua janela em segundos. r é o número de chamadas restantes; t é o número de segundos até uma vaga ficar disponível. São campos estruturados, não números isolados.

Esgotar a cota retorna 429 com o problema rate-limited e Retry-After em segundos. Espere antes de tentar novamente e coordene os clientes que usam a mesma conta. Leituras de tarefas não consomem essa cota de criação de links; siga as orientações de poll_after_seconds e Retry-After.

Janela de buscaCopiar link da seção

As buscas por palavras-chave têm uma janela separada por conta de 30 chamadas a cada 60 segundos. A admissão de busca não consome chamadas de criação de links. Links colados resolvidos de produtos, lojas, planilhas e sites não compatíveis pulam a busca por palavras-chave e não consomem nenhuma janela; os que não puderam ser lidos podem chegar à busca por palavras-chave.

As respostas bem-sucedidas que chegam à admissão de busca por palavras-chave e as recusas por limite de busca incluem:

RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60

Recusas de busca retornam 429 com search-rate-limited e Retry-After. Os campos dos cabeçalhos têm o mesmo significado explicado acima. Reproduzir uma solicitação de criação com Idempotency-Key não consome outra chamada de criação de links; um 429 não é armazenado para reprodução.