TicketsX-LogoTicketsX

Dokumentation

TicketsX schneller lernen

Einrichtungsanleitungen, die vollständige Befehlsreferenz, Premium-Funktionen und die REST-API an einem Ort.

BefehleStatusPreise ansehen

13.6

Beteiligten hinzufügen

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

Gibt einem Nutzer oder einer Rolle Zugriff auf einen Ticket-Kanal. Das Ziel erhält im Ticket Lese- und Schreibrechte.

Anfragekörper

NameTypPflichtfeldBeschreibung
target_idstring
erforderlich
Discord-Nutzer-ID oder Rollen-ID, die hinzugefügt wird.
target_typestring
optional
Art des Ziels. Entweder user oder role (Standard user).

Bei Thread-Tickets gibt es keine Rollen-Überschreibungen, deshalb werden beim Hinzufügen einer role deren Mitglieder einzeln aufgenommen, als Missbrauchsschutz begrenzt auf die ersten 25. Wird die Liste dadurch gekürzt, enthält die Antwort ein Feld note. Bei Kanal-Tickets gibt es diese Grenze nicht, dort deckt eine einzige Berechtigungsüberschreibung die ganze Rolle ab.

Beispielanfrage
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