Noxyr bietet jetzt eine kostenlose, serverbezogene REST-API. Damit holst du Live-Discord-Daten wie Mitgliederzahlen, Ticket-Auswertungen, Aktivitätsmetriken, Verkäufe, Bewertungen und Giveaways in deine Website, dein Dashboard, deine mobile App oder einen anderen Bot. Pro Server gibt es einen Schlüssel, der im Dashboard erzeugt wird. Er ist mit SHA-256-Hashing gesichert und hängt an Bereichsschaltern, die du selbst steuerst.
Warum eine serverbezogene API?
Die meisten Discord-Bots stellen entweder gar keine Daten bereit oder verlangen, dass du dich mit der rohen Discord-API herumschlägst, mit Intents, Gateway-Verbindungen und Berechnungen zu Rate-Limits. Die Noxyr Server API ist das Gegenteil: Du schickst einen Header und bekommst JSON zurück. Sechs Endpunkte beantworten die Fragen, die Serverinhaber tatsächlich stellen: Wie viele Mitglieder gibt es, wie viele Tickets diese Woche, Umsatz pro Währung, durchschnittliche Bewertung, laufende Giveaways, Trend der täglichen Aktivität.
Was du heute abrufen kannst
GET /api/v1/server: Servername, Icon-URL, aktuelle Mitgliederzahl, Anzahl Online, Boosts, Erstellungsdatum.GET /api/v1/tickets: gesamt / offen / geschlossen, in den letzten 7 und 30 Tagen eröffnete Tickets, in den letzten 7 Tagen geschlossene, durchschnittliche Bewertung und Anzahl der Bewertungen.GET /api/v1/activity?days=30: tägliche Nachrichten, Beitritte und Austritte für bis zu 90 Tage, mit Nullen aufgefüllt, sodass jedes Datum vorhanden ist.GET /api/v1/invoices: Rechnungsanzahl, Volumen und Umsatz pro Währung für 7 und 30 Tage sowie eine Aufschlüsselung nach Zahlungsstatus.GET /api/v1/reviews: Gesamtzahl abgegebener Bewertungen, Durchschnittsbewertung, Aufschlüsselung nach 1–5 Sternen und die neuesten 5 Bewertungen (Produkt, Bewertung, kurzer Text, Autor).GET /api/v1/giveaways: Anzahl aktiver und beendeter Giveaways, Teilnahmen insgesamt und die 5 laufenden Giveaways, die als Nächstes enden.
Sicherheitsmodell
Schlüssel beginnen mit nxr_ und enthalten 192 Bit Entropie. Auf dem Server wird nur ein SHA-256-Hash gespeichert. Der Klartext-Schlüssel wird einmal bei der Erzeugung angezeigt und lässt sich danach nicht wiederherstellen. Jede Antwort wird durch zwei Prüfungen geschützt: Ist der Schlüssel aktiviert, und ist der Bereich dieses Endpunkts eingeschaltet? Schaltest du einen Bereich aus, kommt sofort ein 403 zurück. Das Deaktivieren oder Widerrufen eines Schlüssels sperrt jeglichen Zugriff, ohne dass etwas neu bereitgestellt werden muss. Das Rate-Limit gilt pro Schlüssel mit 60 Anfragen pro Minute.
Der Einstieg (60 Sekunden)
- 1. Öffne das Dashboard, wähle deinen Server und geh zu API-Zugriff.
- 2. Klicke auf API-Schlüssel erzeugen und kopiere den Wert. Er wird nur dieses eine Mal angezeigt.
- 3. Schalte die Bereiche ein oder aus. Jeder Bereich hat seinen eigenen Schalter.
- 4. Rufe
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"auf, und du bist live.
Typische Integrationen
Zeige einen Live-Mitgliederzähler auf deiner Landingpage. Poste eine wöchentliche Ticket-Zusammenfassung in einen privaten Team-Kanal. Baue eine öffentliche Bestenliste mit der stärksten Giveaway-Teilnahme. Verbinde Verkaufsdaten mit einer Tabelle oder deinem eigenen Admin-Panel. Da die Antworten einfaches JSON mit großzügigem CORS sind, kannst du die API direkt aus dem Browser aufrufen, ganz ohne Proxy.
Wie es weitergeht
Weiterführend: Discord-API vs. Noxyr Server API, ein Schritt-für-Schritt-Tutorial, die Designprinzipien hinter diesen Endpunkten und wie wir mit Fehlern der Discord-API umgehen.