Como Corrigir o Erro ‘Limite de Taxa Excedido’ no Mastodon ao Publicar em Rápidas Sucessão

Ao publicar vários toots em rápida sucessão, o Mastodon pode responder com um erro de “Limite de taxa excedido” e bloquear sua conta de publicar por vários minutos. Isso acontece porque as instâncias do Mastodon impõem limites de taxa para evitar spam e reduzir a carga do servidor. O erro geralmente aparece como um código de status HTTP 429 com uma mensagem como “Muitas solicitações” ou “Limite de taxa excedido.” Este artigo explica por que publicar em rajadas aciona esses limites e como evitá-los ou se recuperar deles.

Por que os Limites de Taxa do Mastodon São Acionados ao Publicar em Rajadas

Os limites de taxa do Mastodon são um mecanismo do lado do servidor que controla quantas ações uma conta pode realizar dentro de uma janela de tempo deslizante. Para postagens, o limite padrão na maioria das instâncias é de 300 toots a cada 3 horas. Isso é definido na variável de ambiente RATE_LIMIT da instância ou no módulo RateLimiter no código-fonte do Mastodon. Quando você publica vários toots em rajada — por exemplo, 10 toots em 30 segundos — o servidor conta cada postagem contra sua cota. Quando a contagem excede o limite, o servidor retorna um código de status 429 e recusa novas postagens até que a janela seja redefinida.

O limite de taxa se aplica por conta, não por endereço IP. Isso significa que usar vários clientes ou abas do navegador na mesma conta conta para o mesmo limite. O servidor também rastreia a janela de tempo com base na primeira ação na rajada. Se você publicar 300 toots em 10 minutos, deve aguardar o restante da janela de 3 horas antes de publicar novamente. No entanto, a maioria das instâncias implementa uma janela deslizante: cada ação atualiza o início da janela, então publicar continuamente pode estender o bloqueio indefinidamente.

Valores Padrão de Limite de Taxa em Instâncias Populares

Instâncias diferentes podem personalizar esses valores. Por exemplo, mastodon.social usa 300 postagens a cada 3 horas, enquanto instâncias menores podem usar 500 postagens a cada 6 horas. Você pode verificar os limites da sua instância revisando o endpoint /api/v1/instance ou entrando em contato com o administrador. Os campos max_toot_chars e poll_limits também são definidos lá, mas o limite de taxa para postagens normalmente não é exposto na API pública.

Passos para se Recuperar de um Bloqueio de Limite de Taxa

Se você vir o erro “Limite de taxa excedido”, siga estas etapas para restaurar a capacidade de postagem rapidamente.

1. Verifique a mensagem de erro para o tempo de nova tentativa
   Abra as ferramentas de desenvolvedor do navegador (F12) e vá para a aba Network. Encontre a solicitação POST com falha para /api/v1/statuses. Procure pelo cabeçalho Retry-After na resposta. Esse valor, em segundos, informa quanto tempo esperar antes de tentar novamente. Se o cabeçalho estiver ausente, o tempo de espera padrão é de 15 minutos.
2. Pare toda atividade de postagem imediatamente
   Não tente republicar o mesmo toot ou enfileirar novas postagens. Cada solicitação com falha pode redefinir a janela deslizante, estendendo o bloqueio. Feche quaisquer clientes de terceiros que possam estar tentando novamente automaticamente.
3. Aguarde o período completo de nova tentativa antes de postar novamente
   Defina um cronômetro para o número de segundos mostrado em Retry-After. Não verifique sua conta durante esse período. Após o término do período, publique um único toot para confirmar que o limite foi redefinido.
4. Limpe o cache e os cookies do navegador para a instância
   No Chrome, vá em Configurações > Privacidade e segurança > Limpar dados de navegação. Selecione “Cookies e outros dados do site” e “Imagens e arquivos em cache.” Defina o intervalo de tempo como “Última hora.” Clique em “Limpar dados.” Isso remove quaisquer tokens de limite de taxa desatualizados armazenados localmente.
5. Faça logout e login novamente na sua conta
   Isso atualiza o token OAuth e o estado da sessão. O servidor pode redefinir o contador de limite de taxa após um novo login em casos raros, embora isso não seja garantido.

Como Evitar Limites de Taxa ao Publicar em Rajadas

Prevenir limites de taxa requer espaçar suas postagens e entender o limite da sua instância. Use estes métodos para permanecer dentro dos limites.

1. Use um agendador de postagens com atrasos integrados
   Ferramentas como Buffer e Hootsuite permitem agendar toots com um intervalo mínimo entre cada postagem. Defina o intervalo para pelo menos 60 segundos. Isso evita que rajadas se acumulem dentro da janela deslizante.
2. Calcule sua taxa de postagem segura
   Divida o limite da instância pela duração da janela. Para um limite de 300 postagens a cada 3 horas, a taxa segura é de 100 postagens por hora ou 1,67 postagens por minuto. Espace seus toots para ficar abaixo dessa taxa média.
3. Monitore seu limite de taxa restante via API
   Use uma ferramenta como cURL ou Postman para chamar GET /api/v1/accounts/:id/statuses e verifique os cabeçalhos da resposta. O Mastodon retorna os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset nas respostas da API. Acompanhe o valor restante para saber quando você está perto do limite.
4. Use uma conta de bot dedicada para postagens de alto volume
   Se você precisa postar em rajadas regularmente, crie uma segunda conta em uma instância com limites de taxa mais altos ou sem limites de postagem. Instâncias do Mastodon como botsin.space são projetadas para postagem automatizada e podem ter limites mais flexíveis.
5. Distribua postagens em várias contas
   Para postar em diferentes comunidades, use contas separadas em instâncias diferentes. Cada conta tem seu próprio limite de taxa. Isso não viola os termos do Mastodon, desde que você não envie spam com o mesmo conteúdo.

Se os Limites de Taxa Ainda Bloquearem Sua Conta

O limite de taxa persiste após aguardar o período de nova tentativa

Se você esperar o tempo especificado e ainda receber o erro, a janela deslizante pode ter sido estendida por outras ações. Verifique se você também realizou outras ações com limite de taxa, como seguir, impulsionar ou favoritar. Cada uma delas tem limites separados. Pare toda atividade por 30 minutos e tente novamente.

O limite de taxa aparece em um cliente de terceiros, mas não na interface web

Alguns clientes têm seus próprios limites de taxa impostos pelo desenvolvedor do cliente ou pelo registro do aplicativo OAuth da instância. Mude para a interface web oficial do Mastodon ou para um cliente diferente, como Tusky ou Fedilab. Se a interface web funcionar, o cliente é o gargalo. Revogue o token de acesso do cliente em Preferências > Conta > Aplicativos autorizados e crie um novo token.

O limite de taxa bloqueia todas as contas no mesmo IP

Isso é raro, mas possível se o administrador da instância configurou limitação de taxa baseada em IP como fallback. Se você compartilha uma rede com outros usuários do Mastodon, peça a eles que parem de postar temporariamente. Use uma VPN ou proxy para alterar seu endereço IP. Entre em contato com o administrador da instância para confirmar se os limites de IP estão ativos.

Limite de Taxa do Mastodon vs. Limites de Clientes de Terceiros

Item	Limite da Instância Mastodon	Limite do Cliente de Terceiros
Escopo	Por conta em todos os clientes	Por token OAuth para aquele aplicativo específico
Valor padrão	300 postagens a cada 3 horas	Varia; alguns clientes definem 100 postagens por hora
Como verificar	Cabeçalhos de resposta X-RateLimit-	Documentação do cliente ou configurações do aplicativo
Método de redefinição	Aguardar a janela deslizante expirar	Revogar token e criar um novo
Possibilidade de contorno	O administrador pode aumentar o limite por conta	Não é possível; os limites do cliente são codificados

Entender ambas as camadas de limites ajuda você a escolher a ferramenta certa para postagens de alto volume. Se você atingir o limite da instância, nenhum cliente pode ajudar. Se você atingir o limite do cliente, trocar de cliente ou revogar o token resolve o problema.