Godkendelse

API-nøgler oprettes og håndteres i serverens sidemenu i TicketsX-kontrolpanelet. Hver nøgle hører til én server, og for at oprette eller bruge en skal serveren have et aktivt Premium-abonnement.

Opret en nøgle

Slå Premium til for serveren på siden Premium (siden API-adgang linker direkte dertil).
Åbn serverens sidemenu, og gå til API-adgang.
Giv nøglen et navn (for eksempel "Supportbot" eller "CRM-kobling").
Klik på Opret nøgle, og kopiér den værdi, der bliver vist.
Gem den et sikkert sted til hemmeligheder; når du har lukket beskeden, kan du ikke se den igen.

Hvis Premium udløber

Dine nøgler bliver ikke slettet. Alle API-kald begynder at svare 402 med premium_required: true, og du kan ikke oprette eller skifte nøgler, før abonnementet kører igen. Du kan stadig se, slå fra og tilbagekalde nøgler, så du kan rydde op alligevel. Behandl 402 i din integration ligesom 401: hold op med at prøve igen, og giv et menneske besked.

Svar når serveren ikke har Premium

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

Tilbagekalder du en nøgle, holder den op med at virke på alle endepunkter med det samme. Vil du undgå afbrydelser, så opret afløseren først.

Brug en nøgle

Send nøglen som Bearer-header ved hvert kald. Alle kald gælder kun den server, hvor nøglen blev oprettet.

Eksempel på et godkendt kald

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