13
Référence de l'API
L'API REST de TicketsX te permet de relier des outils externes au système de tickets de ton serveur. Crée, ferme et gère des tickets par programme sans passer par l'interface Discord, cherche dans toute ton archive de transcriptions et récupère le texte complet ou le HTML de n'importe quel ticket fermé.
L'API REST est une fonctionnalité Premium. Les jetons d'API ne peuvent être créés et utilisés que tant que le serveur a un abonnement Premium actif (voir la page des tarifs). Les requêtes venant d'un serveur sans Premium sont rejetées avec 402 et un champ premium_required: true. Si Premium prend fin, tes jetons existants sont conservés mais cessent de fonctionner jusqu'à la réactivation. Tu peux toujours les lister, les désactiver et les révoquer depuis le tableau de bord.
https://api.ticketsx.xyzChaque requête nécessite un jeton d'API transmis comme jeton Bearer dans l'en-tête Authorization. Les jetons sont limités à un seul serveur et peuvent être restreints par action.
Authorization: Bearer <API_TOKEN>Dans tous les chemins de points d'accès ci-dessous, remplace <guild_id> par l'identifiant de ton serveur Discord et <ticket_id> par l'identifiant du ticket visé.
Content-Type: application/json est obligatoire pour tous les corps de requête POST. Les réponses 4xx contiennent un champ JSON error. 401 signifie que le jeton est invalide, expiré ou révoqué. 402 signifie que le serveur n'a pas Premium (la réponse contient aussi premium_required: true). 403 signifie que le jeton est désactivé ou n'a pas la permission requise. 429 signifie qu'une limite de débit a été atteinte (voir Limites de débit et sécurité) et inclut une valeur retry_after en secondes.