文档

更快上手 TicketsX

配置指南、完整命令说明、Premium 功能和 REST API 都在这里。

13.3

创建工单

POST/<guild_id>/api/tickets

代表某位用户创建一张新工单。工单会在面板配置的频道中打开,并像平常一样触发欢迎消息和表单显示。

请求体

名称类型必填说明
creator_idstring
必填
开单用户的 Discord 用户 ID。
panel_idnumber
必填
用于开单的工单面板 ID。
contentstring
可选
工单的首条消息内容。
formobject
可选
预先填好的表单回答,以 { "问题": "回答" } 的键值对形式给出。
请求示例
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"
}