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"
}