13
Riferimento API
L'API REST di TicketsX ti permette di collegare strumenti esterni al sistema di ticket del tuo server. Puoi creare, chiudere e gestire i ticket da codice senza passare dall'interfaccia di Discord, cercare in tutto l'archivio delle trascrizioni e scaricare il testo completo o l'HTML di qualsiasi ticket chiuso.
L'API REST è una funzione Premium. I token API si possono creare e usare solo mentre il server ha un abbonamento Premium attivo (vedi la pagina dei prezzi). Le richieste da un server senza Premium vengono rifiutate con 402 e un campo premium_required: true. Se Premium scade, i token esistenti restano ma smettono di funzionare finché non riattivi l'abbonamento. Nel frattempo puoi comunque elencarli, disattivarli e revocarli dalla dashboard.
https://api.ticketsx.xyzOgni richiesta ha bisogno di un token API passato come Bearer token nell'header Authorization. I token valgono per un solo server e possono essere limitati per singola azione.
Authorization: Bearer <API_TOKEN>In tutti i percorsi degli endpoint qui sotto sostituisci <guild_id> con l'ID del tuo server Discord e <ticket_id> con l'ID del ticket interessato.
Per tutti i corpi delle richieste POST serve Content-Type: application/json. Le risposte 4xx includono un campo JSON error; 401 significa che il token non è valido, è scaduto o è stato revocato; 402 significa che il server non ha Premium (la risposta contiene anche premium_required: true); 403 significa che il token è disattivato o non ha il permesso richiesto; 429 significa che hai superato un limite di richieste (vedi Limiti e sicurezza) e include un valore retry_after in secondi.