Noxyr dostarcza teraz darmowe, działające dla pojedynczego serwera REST API, dzięki któremu możesz pobierać dane Discorda na żywo: liczbę członków, analitykę ticketów, wskaźniki aktywności, sprzedaż, opinie i konkursy. Wszystko to trafi na twoją stronę, do panelu, aplikacji mobilnej lub innego bota. Jeden klucz na serwer, generowany z panelu, zabezpieczony haszowaniem SHA-256 i ograniczany przełącznikami zakresów, którymi zarządzasz ty.
Dlaczego API ograniczone do serwera?
Większość botów Discorda albo w ogóle nie udostępnia danych, albo wymaga, byś męczył się z surowym API Discorda, intencjami, połączeniami gateway i matematyką limitów żądań. Noxyr Server API działa odwrotnie: wysyłasz nagłówek i dostajesz JSON. Sześć endpointów obejmuje pytania, które właściciele serwerów faktycznie zadają: ilu mamy członków, ile ticketów w tym tygodniu, przychód w każdej walucie, średnia ocena opinii, trwające konkursy, trend dziennej aktywności.
Co możesz odczytać już dziś
GET /api/v1/server: nazwa serwera, URL ikony, aktualna liczba członków, liczba online, boosty, data utworzenia.GET /api/v1/tickets: łącznie / otwarte / zamknięte, tickety otwarte w ciągu ostatnich 7 i 30 dni, zamknięte w ciągu ostatnich 7 dni, średnia ocena i liczba ocen.GET /api/v1/activity?days=30: dzienne wiadomości, wejścia i wyjścia do 90 dni wstecz, z uzupełnionymi zerami, więc każda data jest obecna.GET /api/v1/invoices: liczba faktur, wolumen z 7 i 30 dni oraz przychód w każdej walucie, plus podział według statusu płatności.GET /api/v1/reviews: łączna liczba opublikowanych opinii, średnia ocena, podział gwiazdek 1–5 i 5 najnowszych opinii (produkt, ocena, krótki tekst, autor).GET /api/v1/giveaways: liczba aktywnych / zakończonych konkursów, łączna liczba zgłoszeń i 5 trwających konkursów, które skończą się jako następne.
Model bezpieczeństwa
Klucze zaczynają się od nxr_ i mają 192 bity entropii. Na serwerze przechowywany jest tylko skrót SHA-256, a surowy klucz jest pokazywany jeden raz w chwili generowania i nie da się go odzyskać. Każda odpowiedź przechodzi dwie kontrole: czy klucz jest włączony oraz czy zakres tego endpointu jest aktywny. Wyłączenie zakresu zwraca od razu 403. Wyłączenie lub unieważnienie klucza odcina cały dostęp bez ponownego wdrażania. Limit żądań działa per klucz i wynosi 60 żądań na minutę.
Pierwsze kroki (60 sekund)
- 1. Otwórz panel, wybierz swój serwer i przejdź do API Access.
- 2. Kliknij Generate API Key i skopiuj wartość. To jedyny moment, w którym jest pokazana.
- 3. Włączaj lub wyłączaj zakresy. Każdy zakres ma własny przełącznik.
- 4. Wywołaj
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"i już działa.
Typowe integracje
Pokaż licznik członków na żywo na swojej stronie głównej. Publikuj cotygodniowe podsumowanie ticketów na prywatnym kanale personelu. Zbuduj publiczną tablicę wyników najaktywniejszych uczestników konkursów. Przenieś dane sprzedażowe do arkusza kalkulacyjnego albo do własnego panelu administracyjnego. Ponieważ odpowiedzi to zwykły JSON z liberalnym CORS, możesz wywoływać API z przeglądarki bez żadnego proxy.
Co dalej
Powiązane lektury: Discord API a Noxyr Server API, samouczek krok po kroku, zasady projektowania stojące za tymi endpointami oraz jak obsługujemy błędy Discord API.