13.6
新增參與者
POST
/<guild_id>/api/tickets/<ticket_id>/participants讓某位使用者或某個身分組可以存取工單頻道。對象會取得在工單中讀取與發言的權限。
請求本文
| 名稱 | 型別 | 必填 | 說明 |
|---|---|---|---|
| target_id | string | 必填 | 要新增的 Discord 使用者 ID 或身分組 ID。 |
| target_type | string | 選填 | 對象類型。填 user 或 role(預設 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