Autentisering

API-nycklar skapas och hanteras i serverns sidomeny i TicketsX-panelen. Varje nyckel hör till en server, och för att skapa eller använda en behöver servern en aktiv Premium-prenumeration.

Skapa en nyckel

Slå på Premium för servern på sidan Premium (sidan API-åtkomst länkar direkt dit).
Öppna serverns sidomeny och gå till API-åtkomst.
Ge nyckeln ett namn (till exempel "Supportbot" eller "CRM-koppling").
Klicka på Skapa nyckel och kopiera värdet som visas.
Spara det i ett hemlighetsvalv; efter att du stängt rutan går det inte att se igen.

Om Premium löper ut

Dina nycklar tas inte bort. Alla API-anrop börjar svara 402 med premium_required: true, och att skapa eller byta nycklar går inte förrän prenumerationen är igång igen. Att lista, stänga av och återkalla nycklar fungerar fortfarande, så du kan rensa upp oavsett. Hantera 402 i din integration precis som 401: sluta försöka igen och larma en människa.

Svar när servern saknar Premium

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

Att återkalla en nyckel gör den ogiltig på alla ändpunkter direkt. Vill du slippa avbrott skapar du ersättaren först.

Använda en nyckel

Skicka nyckeln som Bearer-huvud vid varje anrop. Alla anrop gäller bara servern där nyckeln skapades.

Exempel på autentiserat anrop

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