Noxyr nyní nabízí bezplatné REST API pro každý server, takže můžete načítat živá data z Discordu, počty členů, analytiku tiketů, metriky aktivity, prodeje, recenze a giveaway do svého webu, dashboardu, mobilní aplikace nebo jiného bota. Jeden klíč na server, vygenerovaný z dashboardu, zabezpečený hashováním SHA-256 a řízený přepínači oprávnění (scope), které si sami nastavíte.
Proč API omezené na server?
Většina botů pro Discord buď neposkytuje žádná data, nebo vás nutí drtit surové Discord API s intenty, připojeními na gateway a výpočty limitů rychlosti. Server API Noxyru je opak: pošlete hlavičku a dostanete JSON. Šest endpointů pokrývá otázky, které se majitelé serverů skutečně ptají: kolik je členů, kolik tiketů je tento týden, jaké tržby jsou v jednotlivých měnách, jaké je průměrné hodnocení recenzí, jaké giveaway běží a jaký je denní trend aktivity.
Co lze dnes číst
GET /api/v1/server: název serveru, URL ikony, živý počet členů, počet online, boosty, datum vzniku.GET /api/v1/tickets: celkem / otevřené / uzavřené, tikety otevřené za posledních 7 a 30 dní, uzavřené za posledních 7 dní, průměrné hodnocení a počet hodnocení.GET /api/v1/activity?days=30: denní zprávy, připojení a odchody až za 90 dní, s nulami doplněnými tak, aby byl každý den zastoupen.GET /api/v1/invoices: počty faktur, objem a tržby za 7 a 30 dní v jednotlivých měnách a rozpis podle stavu platby.GET /api/v1/reviews: celkový počet zveřejněných recenzí, průměrné hodnocení, rozpis podle 1–5 hvězdiček a posledních 5 recenzí (produkt, hodnocení, krátký text, autor).GET /api/v1/giveaways: počty aktivních / ukončených, celkový počet účastí a 5 běžících giveaway s nejbližším koncem.
Model zabezpečení
Klíče začínají na nxr_ a nesou 192 bitů entropie. Na serveru se ukládá jen hash SHA-256, surový klíč se zobrazí jednou při vygenerování a nelze ho obnovit. Každá odpověď prochází dvěma kontrolami: je klíč povolený a je zapnutý scope tohoto endpointu? Vypnutí scope vrátí okamžitě 403. Vypnutí nebo odvolání klíče zruší všechen přístup bez nového nasazení. Omezení rychlosti je nastaveno na klíč, na 60 požadavků za minutu.
Začínáme (60 sekund)
- 1. Otevřete dashboard, vyberte svůj server a přejděte na Přístup k API.
- 2. Klikněte na Vygenerovat API klíč a zkopírujte hodnotu. Zobrazí se pouze jednou.
- 3. Zapněte nebo vypněte scope. Každý scope má vlastní přepínač.
- 4. Zavolejte
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"a jste online.
Běžné integrace
Zobrazte živé počítadlo členů na své úvodní stránce. Každý týden posílejte přehled tiketů do soukromého kanálu personálu. Vytvořte veřejný žebříček nejaktivnějších účastníků giveaway. Napojte data o prodejích do tabulky nebo do vlastního administrátorského panelu. Protože odpovědi jsou prostý JSON s povolujícím CORS, můžete API volat z prohlížeče bez jakéhokoli proxy.
Co dál
Související čtení: Discord API versus Server API Noxyru, podrobný návod krok za krokem, principy návrhu, na kterých tyto endpointy stojí a jak řešíme chyby Discord API.