Authentification

Les jetons d'API se créent et se gèrent depuis la barre latérale du serveur dans le tableau de bord TicketsX. Chaque jeton est lié à un seul serveur, et il faut un abonnement Premium actif pour en créer ou en utiliser un.

Créer un jeton

• Active Premium pour le serveur depuis la page Premium (la page Accès API y renvoie directement).
• Ouvre la barre latérale du serveur et va sur Accès API.
• Donne un nom au jeton (par exemple "Bot support" ou "Synchro CRM").
• Clique sur Créer un jeton et copie la valeur affichée.
• Range-la dans un coffre à secrets ; tu ne pourras plus la revoir après avoir fermé le bandeau.

Si Premium prend fin

Tes jetons ne sont pas supprimés. Toutes les requêtes API se mettent à renvoyer 402 avec premium_required: true, et la création ou le renouvellement de jetons est bloqué, jusqu'au retour de l'abonnement. Lister, désactiver et révoquer continue de fonctionner pour que tu puisses faire le ménage malgré tout. Traite 402 dans ton intégration comme tu traites 401 : arrête les tentatives et alerte un humain.

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

Utiliser un jeton

Envoie le jeton en en-tête Bearer à chaque requête. Toutes les requêtes concernent le serveur qui a créé le jeton.

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