O Noxyr agora traz uma API REST gratuita, por servidor, para que você possa puxar dados do Discord ao vivo (contagens de membros, análises de tickets, métricas de atividade, vendas, avaliações e sorteios) para o seu site, painel, aplicativo mobile ou outro bot. Uma chave por servidor, gerada no painel, protegida com hash SHA-256 e controlada por interruptores de escopo que você define.
Por que uma API com escopo de servidor?
A maioria dos bots de Discord ou não expõe dado nenhum ou exige que você trabalhe diretamente com a API bruta do Discord, com intents, conexões gateway e cálculos de limite de taxa. A API do Servidor Noxyr é o oposto: você envia um cabeçalho e recebe JSON. Seis endpoints cobrem as perguntas que os donos de servidor realmente fazem: quantos membros, quantos tickets nesta semana, receita por moeda, nota média das avaliações, sorteios em andamento e a tendência diária de atividade.
O que você pode ler hoje
GET /api/v1/server: nome do servidor, URL do ícone, contagem ao vivo de membros, contagem de online, impulsos, data de criação.GET /api/v1/tickets: total / abertos / fechados, tickets abertos nos últimos 7 e 30 dias, fechados nos últimos 7, nota média e quantidade de notas.GET /api/v1/activity?days=30: mensagens, entradas e saídas diárias por até 90 dias, preenchidas com zero para que cada data esteja presente.GET /api/v1/invoices: quantidade de faturas, volume e receita dos últimos 7 e 30 dias por moeda, além de um detalhamento por status de pagamento.GET /api/v1/reviews: total de avaliações publicadas, nota média, distribuição de 1 a 5 estrelas e as 5 avaliações mais recentes (produto, nota, texto curto, autor).GET /api/v1/giveaways: quantidade de sorteios ativos / encerrados, total de participações e os 5 próximos sorteios em andamento a terminar.
Modelo de segurança
As chaves começam com nxr_ e carregam 192 bits de entropia. Só um hash SHA-256 é armazenado no servidor; a chave bruta é mostrada uma vez no momento da geração e não pode ser recuperada. Cada resposta passa por duas verificações: a chave está habilitada e o escopo desse endpoint está ativado? Desativar um escopo retorna 403 instantaneamente; desabilitar ou revogar uma chave encerra todo o acesso sem precisar de novo deploy. O limite de requisições é por chave: 60 por minuto.
Primeiros passos (60 segundos)
- 1. Abra o painel, escolha o seu servidor e vá em Acesso à API.
- 2. Clique em Gerar chave de API e copie o valor; esta é a única vez em que ele é mostrado.
- 3. Ative ou desative os escopos. Cada escopo tem o seu próprio interruptor.
- 4. Execute
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"e pronto, já está funcionando.
Integrações comuns
Mostre um contador de membros ao vivo na sua página inicial. Publique um resumo semanal de tickets em um canal privado da equipe. Monte um ranking público das maiores participações em sorteios. Envie os dados de vendas para uma planilha ou para o seu próprio painel administrativo. Como as respostas são JSON simples com CORS permissivo, você pode chamar a API direto do navegador, sem nenhum proxy.
O que vem a seguir
Leituras relacionadas: API do Discord vs API do Servidor Noxyr, um tutorial passo a passo, os princípios de design por trás desses endpoints e como lidamos com erros da API do Discord.