Autenticazione

I token API si creano e si gestiscono dalla barra laterale del server nella dashboard di TicketsX. Ogni token è legato a un solo server e per crearlo o usarlo serve un abbonamento Premium attivo.

Creare un token

• Attiva Premium per il server dalla pagina Premium (la pagina Accesso API ci rimanda direttamente).
• Apri la barra laterale del server e vai su Accesso API.
• Dai un nome al token (ad esempio "Bot assistenza" o "Sincronizzazione CRM").
• Clicca su Crea token e copia il valore mostrato.
• Conservalo in un gestore di segreti: dopo aver chiuso l'avviso non potrai più vederlo.

Se Premium scade

I tuoi token non vengono eliminati. Tutte le richieste API iniziano a rispondere 402 con premium_required: true, e la creazione o la rotazione dei token resta bloccata finché l'abbonamento non torna attivo. Elencare, disattivare e revocare i token continua a funzionare, così puoi comunque fare pulizia. Nella tua integrazione gestisci il 402 come gestisci il 401: smetti di riprovare e avvisa una persona.

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

Usare un token

Invia il token come header Bearer a ogni richiesta. Tutte le richieste valgono solo per il server in cui il token è stato creato.

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