Erste Schritte
So verbindest du dich mit der Voxery API.
1. Basis-URL
Alle REST-Anfragen gehen an https://api.voxery.xyz. Es gibt keinen globalen API-Prefix.
2. Authentifizierung
Die meisten Endpunkte erwarten einen Nutzer-JWT oder Bot-Token im Header:
HTTP Header
Authorization: Bearer <accessToken>
Authorization: Bot <botToken>Token erhältst du über POST /auth/login oder in Applications. Details unter Authentifizierung.
3. Berechtigungen
Aktionen hängen von Server-Rollen und Kanal-Overrides ab (ähnlich Discord). Ein Bot braucht z. B. SEND_MESSAGES im Zielkanal.
4. Zwei Integrations-Wege
Webhook (einfach)
Nur senden. Ideal für Benachrichtigungen von externen Diensten.
Gateway-Bot
Empfangen und antworten in Echtzeit über Socket.IO.
Rate Limits
Webhooks: max. 30 Anfragen pro Minute pro Token. REST-Limits können bei hoher Last serverseitig greifen.