說明文件

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