Authentifizierung

API-Tokens erstellst und verwaltest du über die Server-Seitenleiste im TicketsX-Dashboard. Jedes Token gehört zu genau einem Server, und für das Erstellen oder Nutzen braucht der Server ein aktives Premium-Abo.

Ein Token erstellen

Aktiviere Premium für den Server auf der Seite Premium (die Seite API-Zugriff verlinkt direkt dorthin).
Öffne die Server-Seitenleiste und geh zu API-Zugriff.
Gib dem Token einen Namen (zum Beispiel "Support-Bot" oder "CRM-Sync").
Klick auf Token erstellen und kopiere den angezeigten Wert.
Leg ihn in einem sicheren Speicher ab. Nach dem Schließen des Hinweises kannst du ihn nicht mehr einsehen.

Wenn Premium ausläuft

Deine Tokens werden nicht gelöscht. Alle API-Anfragen liefern dann 402 mit premium_required: true, und das Erstellen oder Austauschen von Tokens ist gesperrt, bis das Abo wieder aktiv ist. Auflisten, Deaktivieren und Widerrufen funktioniert weiterhin, damit du trotzdem aufräumen kannst. Behandle 402 in deiner Anbindung wie 401: keine weiteren Versuche, sondern einen Menschen benachrichtigen.

Antwort, wenn der Server kein Premium hat

{
  "error": "The TicketsX REST API is a Premium feature. Activate Premium for this server to use API tokens.",
  "premium_required": true
}

Ein widerrufenes Token ist sofort für alle Endpunkte ungültig. Lege vorher ein Ersatztoken an, wenn es keine Ausfallzeit geben soll.

Ein Token verwenden

Schick das Token bei jeder Anfrage als Bearer-Header mit. Alle Anfragen gelten für den Server, der das Token erstellt hat.

Beispiel für eine authentifizierte Anfrage

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  https://api.ticketsx.xyz/<guild_id>/api/tickets