13.3
创建工单
POST
/<guild_id>/api/tickets代表某位用户创建一张新工单。工单会在面板配置的频道中打开,并像平常一样触发欢迎消息和表单显示。
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| creator_id | string | 必填 | 开单用户的 Discord 用户 ID。 |
| panel_id | number | 必填 | 用于开单的工单面板 ID。 |
| content | string | 可选 | 工单的首条消息内容。 |
| form | object | 可选 | 预先填好的表单回答,以 { "问题": "回答" } 的键值对形式给出。 |
请求示例
curl -X POST \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"creator_id":"123456789","panel_id":1,"content":"Opened via API","form":{"Issue":"Login broken"}}' \
https://api.ticketsx.xyz/<guild_id>/api/tickets响应示例
{
"ticket_id": "42",
"channel_id": "1098765432101234567",
"creator_id": "123456789",
"panel_id": 1,
"status": "open"
}