說明文件

更快上手 TicketsX

設定指南、完整指令說明、Premium 功能和 REST API 都在這裡。

13.6

新增參與者

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

讓某位使用者或某個身分組可以存取工單頻道。對象會取得在工單中讀取與發言的權限。

請求本文

名稱型別必填說明
target_idstring
必填
要新增的 Discord 使用者 ID 或身分組 ID。
target_typestring
選填
對象類型。填 userrole(預設 user)。

討論串形式的工單沒有身分組權限覆寫,因此新增 role 時會逐一加入其成員,並基於防濫用考量最多只加入前 25 位。名單因此被截斷時,回應中會帶上 note 欄位。頻道形式的工單沒有這個限制,一條權限覆寫就能涵蓋整個身分組。

請求範例
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