保利威文档中心

帮助中心

删除学员提问客户回调地址

更新时间: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 以实际为准。)

联系客服,在线咨询