刪除學員提問客戶回調地址
更新時間：2026-05-12 09:48:27
介面描述
刪除當前帳號下的「學員提問」客戶回調配置；刪除後，學員提問成功時不再向原 URL POST 通知。 刪除成功後清除對應 Redis 快取。多次刪除同一帳號為冪等（無記錄時亦回傳成功）。 介面支援 HTTPS 協定。
介面URL
https://api.polyv.net/live/v5/chat/redirect/channel/student-question-webhook/delete
請求方式
POST
介面約束
1、介面同時支援 HTTP、HTTPS，建議使用 HTTPS。
3、**roomId** 與其他 v5 配置類介面一致寫入請求體，用於校驗頻道歸屬；與 post、get（可選 query）行為對齊，避免環境差異。
請求參數描述
| 參數名 | 必選 | 類型 | 說明 |
|---|---|---|---|
| appId | true | String | 帳號 appId【詳見取得金鑰】 |
| timestamp | true | Long | 當前 13 位毫秒級時間戳，3 分鐘內有效 |
| sign | true | String | 簽名，為 32 位大寫的 MD5 值，生成簽名的 appSecret 金鑰作為通訊資料安全的關鍵資訊，嚴禁儲存在用戶端直接使用，所有 API 都必須透過客戶自己伺服器中轉呼叫 POLYV 伺服器取得回應資料【詳見簽名生成規則】 |
| roomId | true | String | 頻道號，用於校驗該頻道是否屬於當前帳號 |
範例
請求體 JSON：
{
"roomId": "412738"
}
回應體 JSON（成功）：
{
"code": 200,
"status": "success",
"message": "删除成功",
"data": ""
}
回應參數描述
| 參數名 | 類型 | 說明 |
|---|---|---|
| code | Integer | 200 表示處理完成（含冪等無記錄） |
| status | String | success / error |
| message | String | 如「刪除成功」 |
| data | String | 成功時多為空字串 |
異常範例
未傳 roomId 導致無法通過頻道校驗時，可能回傳：
{
"code": 400,
"status": "fail",
"message": "roomId非法"
}
未傳 x-auth-user-id：
{
"code": 400,
"status": "fail",
"message": "accountId is required"
}
伺服端異常：
{
"code": 500,
"status": "error",
"message": "unknown error"
}
（具體 message 以實際為準。）
