Noxyr ora offre una REST API gratuita, per singolo server, con cui puoi estrarre dati Discord in tempo reale (conteggi dei membri, analisi dei ticket, metriche di attività, vendite, recensioni e giveaway) nel tuo sito, nella tua dashboard, nell'app mobile o in un altro bot. Una chiave per server, generata dalla dashboard, protetta con hash SHA-256 e regolata da interruttori per ambito che controlli tu.
Perché un'API limitata al server?
La maggior parte dei bot Discord o non espone alcun dato oppure ti costringe a lavorare con la API grezza di Discord, tra intent, connessioni gateway e calcoli sui rate limit. La Noxyr Server API è l'opposto: invii un header e ricevi JSON. Sei endpoint coprono le domande che i proprietari dei server si fanno davvero: quanti membri ci sono, quanti ticket questa settimana, ricavi per valuta, valutazione media delle recensioni, giveaway in corso, andamento giornaliero dell'attività.
Cosa puoi leggere oggi
GET /api/v1/server: nome del server, URL dell'icona, conteggio dei membri in tempo reale, conteggio dei membri online, boost, data di creazione.GET /api/v1/tickets: totali / aperti / chiusi, ticket aperti negli ultimi 7 e 30 giorni, chiusi negli ultimi 7, valutazione media e numero di valutazioni.GET /api/v1/activity?days=30: messaggi giornalieri, ingressi e uscite per un massimo di 90 giorni, con valori a zero per ogni data, così ogni giorno è presente.GET /api/v1/invoices: numero di fatture, volume e ricavi per valuta negli ultimi 7 e 30 giorni, più una suddivisione per stato di pagamento.GET /api/v1/reviews: totale delle recensioni pubblicate, valutazione media, suddivisione per stelle da 1 a 5 e le ultime 5 recensioni (prodotto, valutazione, testo breve, autore).GET /api/v1/giveaways: numero di giveaway attivi / conclusi, partecipazioni totali e i 5 giveaway in corso che terminano per primi.
Modello di sicurezza
Le chiavi iniziano con nxr_ e contengono 192 bit di entropia. Sul server viene memorizzato solo un hash SHA-256; la chiave grezza viene mostrata una sola volta al momento della generazione e non può essere recuperata. Ogni risposta passa due controlli: la chiave è abilitata? Lo scope di questo endpoint è attivo? Disattivare uno scope restituisce subito un 403; disabilitare o revocare una chiave blocca ogni accesso senza bisogno di un nuovo deploy. Il rate limit è per chiave, a 60 richieste al minuto.
Per iniziare (60 secondi)
- 1. Apri la dashboard, scegli il tuo server e vai su Accesso API.
- 2. Clicca su Genera chiave API e copia il valore; è l'unica volta in cui viene mostrato.
- 3. Attiva o disattiva gli scope. Ogni scope ha il proprio interruttore.
- 4. Esegui
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"ed è fatta.
Integrazioni comuni
Mostra un contatore dei membri in tempo reale sulla tua landing page. Pubblica un riepilogo settimanale dei ticket in un canale privato dello staff. Crea una classifica pubblica dei partecipanti più attivi ai giveaway. Collega i dati delle vendite a un foglio di calcolo o a un tuo pannello di amministrazione. Poiché le risposte sono JSON semplice con CORS permissivo, puoi chiamare l'API dal browser senza alcun proxy.
Cosa c'è dopo
Letture correlate: API Discord contro la Noxyr Server API, un tutorial passo dopo passo, i principi di progettazione alla base di questi endpoint e come gestiamo gli errori dell'API Discord.