跳到主要内容

接收 CDN 推流回调

融云在低延迟直播旁路推流到融云 CDN 或第三方 CDN 时,支持将推流的状态变化实时通知您的服务器。

回调方法

POST<your-receiving-server-url>

数据格式application/json

回调地址 <your-receiving-server-url> 是您在控制台为当前 App Key 和服务所配置的回调接收地址。请务必配置可正常访问的回调接收地址。如果您的网络有 IP 访问限制,请务必配置 IP 白名单,否则无法正常接收服务端回调。

为了验证数据有效性并确保调用者为融云 Server,每个请求前添加数据签名。回调签名规则详见服务端回调

回调正文参数

该回调服务的 HTTP 请求正文数据格式为 application/json,包含具有以下结构的 JSON 对象:

字段名称类型说明
timestampNumber时间戳,从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数。
typeNumber状态类型:
1: 开始旁路推流;
2: 旁路推流结束;
3: 旁路推流配置更新;
4: 旁路推流失败
appKeyString当前在使用的 AppKey
sessionIdString当前直播的会话 ID
roomIdString当前直播的房间 ID
pushUrlString旁路推流的 CDN 地址
userIdString设置旁路推流的主播用户 ID
output.videoResoulationString视频分辨率,宽 x 高
stateCodeNumber状态码

回调请求示例

POST /any-url-path HTTP/1.1
Host: your.app.server
Content-Type: application/json

{
"timestamp":1593483553055,
"type":2,
"stateCode":10000,
"appKey":"qf3d5gbjq962h",
"roomId":"iOS-MUJERjYwNTk5MTkyMERCMTFDQkRGODUwODIwNEM0RUI-1593483530019",
"sessionId":"AtqSLHUE_29wd2o6QKM4u7",
"userId":"A2BDE07D-5273-487A-8997-99BF25D06DFE",
"pushUrl":"rtmp://rongcloud.net/seal/AtqSLo6QKM4u7?auth_key=1593487130ace2de7f67c1111",
"output":{
"videoResoulation":"240x320"
}
}

响应回调请求

您的服务在收到 HTTP 回调之后,需要返回 200 OK 表示接收成功。