A API oficial do Discord é uma superfície de baixo nível feita para bots e clientes; você lida com eventos do gateway, faz o cache manualmente e precisa equilibrar os intents. A API de Servidor da Noxyr é uma API HTTP de alto nível, restrita a um único servidor, que retorna análises já prontas. Elas resolvem problemas diferentes. Veja quando usar cada uma.
O que a API do Discord oferece
A documentação da API do Discord (muito pesquisada; o Google Trends mostra consultas por "discord api documentation" com alta de 700% em relação ao ano anterior) é a fonte da verdade para tudo o que o próprio Discord controla: mensagens, usuários, servidores, cargos, canais, voz, threads, moderação. Você tem uma API REST para ações e um gateway WebSocket para eventos. Criar qualquer coisa em tempo real exige manter uma conexão persistente, tratar o READY e os heartbeats, invalidar o cache e lidar com os buckets de limite de taxa.
O que a API de Servidor da Noxyr oferece
A API de Servidor da Noxyr é uma superfície bem menor: seis endpoints somente leitura, restritos a um único servidor por meio de um bearer token. Ela responde perguntas como "quantos tickets neste mês?" ou "receita por moeda", que a API do Discord simplesmente não consegue responder, porque os dados subjacentes ficam no banco de dados da Noxyr, e não no Discord.
Lado a lado
- Autenticação: o Discord usa OAuth2 ou tokens de bot com intents. A Noxyr usa um bearer token por servidor.
- Transporte: o Discord é REST + gateway WebSocket. A Noxyr é HTTPS simples, com CORS habilitado para navegadores.
- Escopo: o Discord é global para o seu bot em todos os servidores em que ele está. A Noxyr é vinculada a um servidor específico.
- Formato dos dados: o Discord retorna objetos brutos: servidores, membros, mensagens. A Noxyr retorna agregados, totais, médias e buckets diários.
- Limites de taxa: o Discord usa limites em buckets por rota. A Noxyr tem um limite fixo de 60 req/min por chave.
- Esforço de configuração: o Discord exige um app de bot, convite, intents e manipuladores de eventos. A Noxyr exige um clique para gerar uma chave.
Escolha o Discord quando…
- Você precisa de eventos em tempo real (uma mensagem chegou, um membro entrou, um canal de voz mudou).
- Você quer enviar mensagens, editar canais, banir usuários ou gerenciar cargos a partir do seu app.
- Você está criando um bot do Discord ou um cliente de terceiros para o Discord.
Escolha a API de Servidor da Noxyr quando…
- Você quer exibir estatísticas ao vivo do servidor em um site público sem manter um bot.
- Você precisa de análises de tickets, dados de vendas, médias de avaliações ou participação em sorteios: dados que o Discord não armazena.
- Você quer um JSON compatível com CORS que pode ser chamado de um painel no navegador, sem proxy.
- Você quer uma superfície estável e versionada, em que alternar escopos permite cortar a exposição de dados sem reimplantar nada.
Usando as duas juntas
As duas APIs combinam bem. Use a API do Discord no seu próprio bot para reagir a eventos, e a API de Servidor da Noxyr para ler o estado agregado no seu site. Assim, o seu painel público não precisa de intents de bot nem de conexões com o gateway; uma única requisição HTTPS basta.
Mais: tutorial da API de Servidor, princípios de design, como lidar com erros da API do Discord.