文档

更快上手 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