Documentation

Prends TicketsX en main plus vite

Guides d'installation, référence complète des commandes, fonctionnalités Premium et API REST au même endroit.

13.6

Ajouter un participant

POST/<guild_id>/api/tickets/<ticket_id>/participants

Donne à un utilisateur ou à un rôle l'accès au salon d'un ticket. La cible obtient les permissions de lecture et d'écriture dans le ticket.

Corps de la requête

Nom	Type	Obligatoire	Description
target_id	string	requis	Identifiant Discord d'utilisateur ou de rôle à ajouter.
target_type	string	facultatif	Type de cible. Soit `user`, soit `role` (`user` par défaut).

Sur les tickets en fil, les fils n'ont pas de permissions par rôle : ajouter un role ajoute donc ses membres un par un, dans la limite des 25 premiers, en garde-fou contre les abus. Quand la liste est tronquée, la réponse contient un champ note. Les tickets en salon n'ont pas cette limite, une seule permission couvre tout le rôle.

Exemple de requête

curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"target_id":"111222333","target_type":"user"}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/participants