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