Die offizielle Discord-API ist eine Schnittstelle auf niedriger Ebene für Bots und Clients. Du arbeitest mit Gateway-Ereignissen, cachest manuell und jonglierst mit Intents. Die Noxyr-Server-API ist eine übergeordnete HTTP-API für einen einzelnen Server, die fertige Auswertungen zurückgibt. Sie lösen unterschiedliche Probleme. Hier siehst du, wann du zu welcher greifen solltest.
Was dir die Discord-API bietet
Die Discord-API-Dokumentation (stark nachgefragt, Google Trends zeigt Suchanfragen nach „discord api documentation“ mit 700 % im Jahresvergleich) ist die maßgebliche Quelle für alles, was Discord selbst gehört: Nachrichten, Nutzer, Server, Rollen, Kanäle, Sprache, Threads, Moderation. Für Aktionen bekommst du eine REST-API, für Ereignisse ein WebSocket-Gateway. Alles, was in Echtzeit läuft, erfordert eine dauerhafte Verbindung, die Behandlung von READY und Heartbeats, Cache-Invalidierung und Ratenlimit-Buckets.
Was dir die Noxyr-Server-API bietet
Die Noxyr-Server-API ist eine deutlich kleinere Schnittstelle: sechs reine Lese-Endpunkte, auf einen einzelnen Server beschränkt, über einen Bearer-Token. Sie beantwortet Fragen wie „Wie viele Tickets gab es diesen Monat?“ oder „Umsatz pro Währung“, die die Discord-API überhaupt nicht beantworten kann, weil die zugrunde liegenden Daten in der Noxyr-Datenbank liegen und nicht bei Discord.
Im direkten Vergleich
- Authentifizierung: Discord nutzt OAuth2 oder Bot-Tokens mit Intents. Noxyr nutzt einen Bearer-Token pro Server.
- Übertragung: Discord ist REST plus WebSocket-Gateway. Noxyr ist einfaches HTTPS mit aktiviertem CORS für Browser.
- Geltungsbereich: Discord gilt global für deinen Bot auf allen Servern, in denen er ist. Noxyr ist an einen bestimmten Server gebunden.
- Datenform: Discord liefert rohe Objekte, Server, Mitglieder, Nachrichten. Noxyr liefert Aggregate, Summen, Durchschnittswerte, Tagesblöcke.
- Ratenlimits: Discord nutzt Buckets pro Route. Noxyr hat ein festes Limit von 60 Anfragen pro Minute und Schlüssel.
- Einrichtungsaufwand: Discord braucht eine Bot-Anwendung, eine Einladung, Intents und Event-Handler. Noxyr braucht einen Klick, um einen Schlüssel zu erzeugen.
Wähle Discord, wenn…
- du Echtzeit-Ereignisse brauchst (eine Nachricht ist eingegangen, ein Mitglied ist beigetreten, ein Sprachkanal hat sich geändert).
- du aus deiner App Nachrichten senden, Kanäle bearbeiten, Nutzer bannen oder Rollen verwalten willst.
- du einen Discord-Bot oder einen Drittanbieter-Discord-Client baust.
Wähle die Noxyr-Server-API, wenn…
- du Live-Serverstatistiken auf einer öffentlichen Website anzeigen willst, ohne einen Bot zu pflegen.
- du Ticket-Auswertungen, Verkaufsdaten, Bewertungsdurchschnitte oder die Teilnahme an Gewinnspielen brauchst, also Daten, die Discord nicht speichert.
- du JSON mit CORS-Unterstützung willst, das du ohne Proxy aus einem Browser-Dashboard aufrufen kannst.
- du eine stabile, versionierte Schnittstelle willst, bei der Bereichsschalter die Datenfreigabe abschalten, ohne etwas neu zu deployen.
Beide zusammen nutzen
Die beiden APIs ergänzen sich gut. Nutze die Discord-API in deinem eigenen Bot, um auf Ereignisse zu reagieren, und die Noxyr-Server-API, um den zusammengefassten Zustand auf deiner Website auszulesen. So braucht dein öffentliches Dashboard überhaupt keine Bot-Intents oder Gateway-Verbindungen. Eine einzige HTTPS-Anfrage reicht.
Mehr dazu: Tutorial zur Server-API, Gestaltungsprinzipien, Umgang mit Discord-API-Fehlern.