O que é um limite de requisições da API? — Ferramenta gratuita
Um limite de requisições da API é o teto que uma plataforma coloca em quantas chamadas um aplicativo pode fazer numa janela de tempo. O que acontece quando uma ferramenta o atinge, por que é um atraso e não uma falha, e o que isso significa para agendamento e análises.
O teto que a plataforma impõe ao número de requisições que um app pode fazer à sua API em um intervalo. Atingi-lo faz ferramentas de publicação ou análise falharem temporariamente até o intervalo reiniciar.
O que é
Um limite de requisições é o teto que uma plataforma coloca em quantas chamadas de API um aplicativo pode fazer dentro de uma janela fixa: tantas chamadas a cada quinze minutos, por hora ou por dia. Existe para que um aplicativo não consuma uma capacidade que é de todos, e vale para o aplicativo, não para você.
Como é medido
A janela é a parte que importa e a que as pessoas pulam. Um limite de mil chamadas por hora não significa mil chamadas espalhadas; significa que o aplicativo pode gastar a cota inteira em um minuto e esperar cinquenta e nove. Quando a cota acaba, a plataforma responde com um 429, muitas vezes com um cabeçalho dizendo quando a janela reinicia. As ferramentas bem-comportadas leem esse cabeçalho e esperam. As outras tentam de novo na hora, são recusadas outra vez, e transformam um atraso em falha comunicada.
Mal-entendido comum
Parece que há algo errado na sua conta, e não há. Nada num limite de requisições é um julgamento sobre o seu perfil, o seu conteúdo ou a sua situação, e é justamente por isso que um atraso de publicação causado por um se resolve sozinho sem você mudar nada. A confusão vizinha é com uma suspensão: de fora, um aplicativo limitado e um que teve o acesso revogado parecem ambos "parou de funcionar". A diferença é que um limite de requisições diz quando termina.
Quando importa
Importa quando muita coisa acontece junto: um lote grande agendado para o mesmo minuto, um mês de análises sendo preenchido de volta, ou várias contas sendo atualizadas juntas. Por isso as ferramentas de publicação distribuem o trabalho em vez de disparar tudo na hora cheia, e por isso uma métrica que falta de manhã costuma estar lá à tarde.
Termos relacionados
Recursos
- Definição clara, com a janela como a parte que importa
- O que é uma resposta 429 e por que não é um erro na sua conta
- Por que lacunas nas análises e publicação atrasada costumam ter a mesma causa
- Como as ferramentas bem-feitas aguardam em vez de tentar de novo na hora
- A diferença entre um limite de requisições e uma suspensão, que de fora se parecem
Perguntas frequentes
O que acontece quando um limite é atingido?
A plataforma recusa novas requisições até a janela reiniciar, normalmente com uma resposta 429. Uma ferramenta bem construída espera e tenta de novo; uma mal construída informa uma falha que nunca foi sua.
Atingir um limite prejudica minha conta?
Não. É um teto sobre um aplicativo, não uma punição sobre você. Insistir contra o limite em vez de aguardar pode acabar restringindo o próprio aplicativo, mas isso afeta a situação dele e não o seu perfil.
Por que falta um dia nas minhas análises?
Um limite de requisições é uma das causas habituais. As métricas são coletadas perguntando à plataforma sobre cada publicação, então uma janela esgotada deixa uma lacuna que se preenche na passagem seguinte em vez de nunca chegar.
É a mesma coisa que shadowban?
Não, embora sejam confundidos porque os dois parecem algo que em silêncio deixou de funcionar. Um limite de requisições é um teto documentado com hora de reinício e um código de resposta explícito. Uma queda de distribuição não tem nenhum dos dois.
Posso aumentar o limite?
Não como usuário de uma ferramenta. Os limites são definidos pela plataforma por aplicativo e dependem do nível de acesso concedido a ele, então a resposta está sempre do lado da ferramenta e não nas suas configurações.
