Pular para o conteúdo principal

O que é

A Mellowtel automaticamente limita quantas requisições um único dispositivo (um “nó”) aceitará e processará. O limite é imposto dentro do SDK. Você não o configura, e um parceiro com mau comportamento não pode aumentá-lo de fora.

Por que é importante

Todo o produto depende de os usuários não perceberem que a Mellowtel está em execução. Se um nó atendesse a requisições ilimitadas, um usuário em uma conexão lenta sentiria isso em seu navegador. A limitação de taxa é o mecanismo que protege essa promessa, e é por isso que você pode enviar a Mellowtel para usuários reais sem se preocupar com tickets de suporte sobre “o navegador parece lento.”

Como funciona

Cada requisição é realizada dentro de uma janela isolada que é criada para a requisição e desmontada imediatamente após. Este é o mesmo modelo de isolamento usado por redes de anúncios como o Google AdSense, com a garantia adicional de que a janela é sem credenciais (veja Privacidade). Como cada requisição é de curta duração e isolada, o único fator que importa para a experiência do usuário é quantas são executadas, e é isso que a limitação de taxa controla. O limite atual varia com base em:
  • Velocidade da largura de banda: conexões mais lentas recebem menos requisições.
  • Geolocalização: a capacidade é balanceada regionalmente.
  • Disponibilidade geral da rede: o SDK reduz quando a demanda global é baixa.
TODO: Documentar números concretos (limites de req/min, níveis geográficos, limiares de largura de banda) assim que finalizados. Por enquanto, os limites são intencionalmente adaptativos e não expostos via a API pública.

Superfície da API

Não há uma API de limitação de taxa para chamar. A restrição é interna e sempre ativa. Você não pode desativá-la, e não deve precisar inspecioná-la. Se você acredita que a limitação de taxa está causando um problema em sua integração, abra uma questão no GitHub ou nos contate no Discord.

Relacionados

  • Privacidade: o que a janela isolada pode e não pode acessar.
  • Opt-in / Opt-out: a camada de consentimento que fica à frente de tudo isso.