Authenticatie

API-tokens maak en beheer je via de zijbalk van je server in het TicketsX-dashboard. Elk token hoort bij één server, en om er een te maken of te gebruiken heeft die server een lopend Premium-abonnement nodig.

Een token aanmaken

• Zet Premium aan voor de server op de pagina Premium (de pagina API-toegang linkt er rechtstreeks naartoe).
• Open de zijbalk van je server en ga naar API-toegang.
• Geef het token een naam (bijvoorbeeld "Supportbot" of "CRM-koppeling").
• Klik op Token aanmaken en kopieer de waarde die je ziet.
• Bewaar hem in een kluis voor geheimen; na het sluiten van de melding kun je hem niet meer bekijken.

Als Premium afloopt

Je tokens worden niet verwijderd. Elk API-verzoek geeft dan 402 met premium_required: true, en tokens aanmaken of vervangen kan niet tot het abonnement weer loopt. Bekijken, uitzetten en intrekken blijft werken, zodat je hoe dan ook kunt opruimen. Behandel 402 in je koppeling net als 401: stop met opnieuw proberen en waarschuw iemand.

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

Een token gebruiken

Stuur het token bij elk verzoek mee als Bearer-header. Alle verzoeken gelden alleen voor de server waar het token is aangemaakt.

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