Autentificare

Jetoanele API se creează și se administrează din bara laterală a serverului, în panoul TicketsX. Fiecare jeton este legat de un singur server, iar pentru a crea sau folosi unul, serverul are nevoie de un abonament Premium activ.

Crearea unui jeton

Activează Premium pentru server din pagina Premium (pagina Acces API trimite direct acolo).
Deschide bara laterală a serverului și intră la Acces API.
Dă un nume jetonului (de exemplu "Bot de asistență" sau "Sincronizare CRM").
Apasă pe Creează jeton și copiază valoarea afișată.
Păstreaz-o într-un seif de secrete; după ce închizi mesajul, nu o mai poți vedea.

Dacă Premium expiră

Jetoanele tale nu se șterg. Toate cererile API încep să răspundă cu 402 și cu premium_required: true, iar crearea sau înlocuirea jetoanelor este blocată până când abonamentul devine iar activ. Afișarea, oprirea și anularea jetoanelor merg în continuare, așa că poți face curat oricum. Tratează 402 în integrarea ta la fel ca 401: oprește reîncercările și anunță un om.

Răspunsul când serverul nu are Premium

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

Anularea unui jeton îl scoate imediat din uz pe toate punctele de acces. Dacă nu îți permiți o pauză, creează mai întâi jetonul de schimb.

Folosirea unui jeton

Trimite jetonul ca antet Bearer la fiecare cerere. Toate cererile sunt valabile doar pentru serverul pe care a fost creat jetonul.

Exemplu de cerere autentificată

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