API-Dokumentation
Schlüssel erstellst du im Dashboard unter „API und Webhooks“. Die API ist schreibgeschützt und liefert nur Zahlen, keine Personendaten.
Anmeldung
Sende den Schlüssel (beginnt mit nk_) als Bearer-Token. Ein Schlüssel gilt für genau einen Server.
GET /api/v1/stats
Mitglieder, aktive Mitglieder, XP und Sprachzeit sowie der Verlauf der letzten Tage.
GET /api/v1/monitors
Status, Antwortzeit und 24-Stunden-Verfügbarkeit deiner Server-Monitore.
Webhooks
Neytrilla sendet Ereignisse (z. B. moderation.action) per POST an deine HTTPS-Adresse. Header: X-Neytrilla-Event (Ereignisname) und X-Neytrilla-Signature (sha256=<HMAC-SHA256 des Rohtexts mit deinem Geheimnis>). Prüfe die Signatur, bevor du dem Inhalt traust.
Grenzen
Fehlercodes: 401 Schlüssel fehlt oder ungültig, 429 zu viele Anfragen (Retry-After: 60). Bitte höchstens einmal pro Minute abfragen.