Mensagem ‘Limite de Taxa Excedido’ no Mastodon: Quanto Tempo Esperar

A mensagem ‘Limite de Taxa Excedido’ no Mastodon aparece quando você envia muitas solicitações a um servidor em pouco tempo. Isso pode acontecer ao atualizar a timeline rápido demais, usar aplicativos de terceiros que consultam o servidor agressivamente ou executar scripts automatizados que interagem com a API do Mastodon. O servidor deliberadamente reduz sua velocidade para proteger seus recursos e garantir acesso justo a todos os usuários.

Este artigo explica por que os limites de taxa existem, quanto tempo você normalmente precisa esperar antes que o limite seja redefinido e como evitar acionar a mensagem novamente. Você aprenderá as durações exatas de tempo limite para ações comuns como postar, seguir e buscar a timeline. Você também obterá etapas práticas para reduzir a frequência de suas solicitações e manter sua conta ativa sem interrupções.

Por que o Mastodon Impõe Limites de Taxa

As instâncias do Mastodon são administradas por voluntários ou pequenas equipes em servidores compartilhados ou com recursos limitados. Cada solicitação recebida consome tempo de CPU, memória e conexões de banco de dados. Sem limites de taxa, um único usuário ou um cliente mal configurado poderia saturar o servidor, degradando a experiência de todos os outros na instância.

Os limites de taxa são aplicados por endereço IP, por token de usuário e, às vezes, por endpoint. O limite mais comum é de 300 solicitações a cada 5 minutos para a API principal. Quando você excede esse limite, o servidor retorna o código de status HTTP 429 com o corpo {"error":"Rate limit exceeded. Try again in X seconds."}.

Como o Servidor Rastreia Suas Solicitações

O Mastodon usa um algoritmo de janela deslizante. Cada solicitação é registrada com um timestamp. O servidor conta quantas solicitações você fez nos últimos 5 minutos. Se a contagem exceder 300, o servidor bloqueia novas solicitações até que o timestamp mais antigo saia da janela. Isso significa que o tempo de espera não é fixo; depende de quando você fez a primeira solicitação que o ultrapassou o limite.

Quanto Tempo Você Deve Esperar para a Redefinição do Limite de Taxa

O tempo de espera varia de acordo com o tipo de solicitação e a configuração da instância. Abaixo estão as durações de tempo limite padrão para as ações mais comuns.

1. Limite de taxa geral da API (300 solicitações a cada 5 minutos)
   Se você exceder esse limite, deve esperar até que a solicitação mais antiga em sua janela deslizante expire. Na prática, isso geralmente leva de 60 a 300 segundos a partir do momento em que você recebe o erro 429. Verifique o cabeçalho de resposta Retry-After para o número exato de segundos que o servidor recomenda.
2. Postar status (toots)
   A maioria das instâncias permite cerca de 30 status a cada 30 minutos. Se você atingir esse limite, aguarde 30 minutos antes de postar novamente. O servidor retorna o tempo restante no cabeçalho X-RateLimit-Reset.
3. Seguir ou deixar de seguir contas
   O Mastodon limita ações de seguir a aproximadamente 100 por hora. Se você exceder isso, aguarde 60 minutos. O limite é redefinido exatamente 60 minutos após a primeira ação de seguir que acionou o bloqueio.
4. Buscar a timeline pública ou inicial
   Atualizações manuais são limitadas a cerca de 1 solicitação por segundo. Se você atualizar com mais frequência, o servidor pode retornar um erro 429. Aguarde 60 segundos antes de atualizar novamente.
5. Pesquisar hashtags ou contas
   Os endpoints de pesquisa têm um limite menor de 30 solicitações por minuto. Se você exceder isso, aguarde 2 minutos antes de pesquisar novamente.

Para ver o status exato do seu limite de taxa, abra as ferramentas de desenvolvedor do navegador (F12) e inspecione a aba de rede. Procure por qualquer resposta da API que inclua os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. O cabeçalho X-RateLimit-Reset contém um timestamp Unix. Converta-o para sua hora local para saber o segundo exato em que o limite é redefinido.

Erros Comuns que Acionam Erros de Limite de Taxa

Muitos usuários atingem o limite de taxa sem perceber que estão fazendo muitas solicitações. Os cenários a seguir são as causas mais frequentes.

Usar Múltiplos Clientes de Terceiros Simultaneamente

Se você tem o aplicativo web oficial do Mastodon aberto, mais um cliente desktop como Whalebird e um aplicativo móvel como Tusky, cada cliente envia suas próprias solicitações. Juntos, eles podem esgotar rapidamente o limite de 300 solicitações. Feche clientes não utilizados ou saia de aplicativos que você não está usando ativamente.

Extensões de Navegador com Atualização Automática Agressiva

Extensões que atualizam automaticamente as abas a cada poucos segundos podem acionar limites de taxa mesmo quando você não está lendo ativamente. Desative qualquer extensão de atualização automática para sua aba do Mastodon. Se precisar monitorar uma timeline, use o botão de atualização integrado em vez de recarregamentos automatizados.

Executar Scripts ou Bots Sem Ritmo Adequado

Se você usa um script personalizado para buscar dados do Mastodon, certifique-se de incluir um atraso de pelo menos 1 segundo entre as solicitações. Muitos administradores de instância bloqueiam permanentemente IPs que ignoram os limites de taxa. Use a função sleep() em seu script para respeitar os limites do servidor.

Compartilhar um Endereço IP com Outros Usuários

Se você está em uma rede de escola, escritório ou Wi-Fi público, seu endereço IP é compartilhado com muitos outros usuários do Mastodon. As solicitações deles contam para o mesmo pool de 300 solicitações. Se você for limitado enquanto outros também estão ativos, aguarde 5 minutos e tente novamente. Considere usar uma VPN pessoal se isso acontecer com frequência.

Comparação de Limites de Taxa: Mastodon vs Twitter vs Bluesky

Entender como os limites de taxa do Mastodon se comparam com outras plataformas ajuda a definir expectativas realistas para a frequência de postagem e navegação.

Item	Mastodon	Twitter (X)	Bluesky
Solicitações padrão por janela	300 a cada 5 minutos	450 a cada 15 minutos (autenticação de usuário)	5000 a cada 5 minutos (senhas de aplicativo)
Limite de postagem	30 a cada 30 minutos	300 a cada 3 horas	100 por minuto
Limite de seguir	100 por hora	400 a cada 24 horas	100 por hora
Atualização da timeline	1 por segundo	1 a cada 15 segundos	1 por segundo
Cabeçalho para tempo de redefinição	X-RateLimit-Reset	X-RateLimit-Reset	ratelimit-reset

O Bluesky oferece um limite de solicitações padrão muito maior, mas seu limite de seguir é semelhante ao do Mastodon. O limite por janela do Twitter é maior, mas seu limite de postagem é mais restritivo em uma janela mais longa. Os limites do Mastodon são moderados e projetados para proteger servidores menores de sobrecarga.

O Que Fazer se os Limites de Taxa Persistirem

Se você atingir consistentemente o limite de taxa mesmo após espaçar suas solicitações, entre em contato com o administrador da sua instância. O administrador pode aumentar seu limite de taxa pessoal adicionando seu ID de usuário ao arquivo config/initializers/rack_attack.rb no servidor. Peça educadamente e explique por que você precisa de um limite maior, por exemplo, se você executa um bot legítimo que posta atualizações infrequentes.

Você também pode mudar para uma instância maior do Mastodon com limites padrão mais altos. Instâncias como mastodon.social ou mstdn.jp geralmente têm limites de taxa mais generosos porque possuem mais recursos de servidor. Verifique a página ‘Sobre’ da instância para sua política específica de limite de taxa antes de entrar.

Agora você sabe que a mensagem ‘Limite de Taxa Excedido’ geralmente é resolvida em 5 minutos para uso geral da API, em 30 minutos para postagem e em 60 minutos para seguir. Verifique o cabeçalho X-RateLimit-Reset na aba de rede do seu navegador para obter o tempo exato de redefinição para sua situação. Para evitar bloqueios futuros, feche clientes de terceiros não utilizados, desative extensões de atualização automática e adicione um atraso de 1 segundo entre quaisquer solicitações de script personalizado. Se precisar de acesso de alto volume sustentado, peça ao administrador da sua instância uma exceção ou mude para um servidor maior.