Documentația API

API-ul REST al TicketsX îți dă voie să legi unelte din afară de sistemul de tichete al serverului tău. Creezi, închizi și gestionezi tichete din cod, fără interfața Discord, cauți în toată arhiva de transcrieri și iei textul complet sau codul HTML al oricărui tichet închis.

API-ul REST este o funcție Premium. Jetoanele API pot fi create și folosite doar cât timp serverul are un abonament Premium activ (vezi pagina de prețuri). Cererile venite de la un server fără Premium sunt respinse cu 402 și cu câmpul premium_required: true. Dacă Premium expiră, jetoanele tale se păstrează, dar nu mai funcționează până la reactivare. Între timp le poți vedea, opri și anula din panou.

Adresă de bazăhttps://api.ticketsx.xyz

Bearer Token

Fiecare cerere are nevoie de un jeton API trimis ca jeton Bearer în antetul Authorization. Jetoanele sunt legate de un singur server și pot fi limitate pe fiecare acțiune.

Authorization: Bearer <API_TOKEN>

În toate căile de mai jos, înlocuiește <guild_id> cu ID-ul serverului tău de Discord și <ticket_id> cu ID-ul tichetului vizat.

Toate cererile POST au nevoie de Content-Type: application/json. Răspunsurile 4xx includ câmpul JSON error; 401 înseamnă că jetonul nu este valid, a expirat sau a fost anulat; 402 înseamnă că serverul nu are Premium (răspunsul conține și premium_required: true); 403 înseamnă că jetonul este oprit sau nu are permisiunea necesară; 429 înseamnă că ai atins o limită (vezi Limite și siguranță) și include o valoare retry_after în secunde.