13.15
切換工單所屬面板
POST
/<guild_id>/api/tickets/<ticket_id>/switch-panel把工單轉到另一個單一面板。這是 /switchpanel 指令的 API 版本。工單會依新面板的命名規則重新命名,頻道形式的工單還會移到新面板的分類下,新面板的客服團隊也會取得存取權。需要 `switch_panel` 權限(預設關閉)。
請求本文
| 名稱 | 型別 | 必填 | 說明 |
|---|---|---|---|
| panel_id | number | 必填 | 工單要切換到的單一面板 ID(參見「列出面板」)。 |
| keep_permissions | boolean | 選填 | 在新面板團隊之外,同時保留頻道目前的身分組權限(預設 true)。設為 false 會把身分組存取權重設為只保留新面板的客服團隊。 |
工單形式必須一致:頻道形式的工單只能切換到頻道形式的面板,討論串形式的工單只能切換到討論串形式的面板。由於切換會重新命名頻道,Discord 把這項操作限制在每 10 分鐘約兩次;本端點與之一致,超出時會回傳 429 並帶上 retry_after。
請求範例
curl -X POST \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"panel_id":2,"keep_permissions":true}' \
https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/switch-panel回應範例
{
"message": "Panel switched to `Billing` successfully.",
"ticket_id": 42,
"panel_id": 2,
"keep_permissions": true
}