接口定义
|
接口描述 |
推送数据到CP指定URL |
|
接口地址 |
CP指定URL |
|
接口协议 |
HTTP POST |
|
HTTP HEADER |
Content-Type=application/json |
请求参数
通知类型
live_status 通知
|
名称 |
说明 |
数据类型 |
最大长度 |
可空 |
|
type |
通知类型(live_status) |
String |
20 |
否 |
|
channel_web_id |
视频webid |
String |
100 |
否 |
|
live_status |
直播状态码(详见 直播状态表) |
String |
10 |
否 |
|
duration |
视频时长(单位:秒) |
Integer |
10 |
是 |
|
screenshot |
视频截图(详见 截图地址拼接说明) |
String |
200 |
是 |
live_screenshot 通知
|
名称 |
说明 |
数据类型 |
最大长度 |
可空 |
|
type |
通知类型(live_screenshot) |
String |
20 |
否 |
|
channel_web_id |
视频webid |
String |
100 |
否 |
|
screenshot |
视频截图(全路径截图地址) |
String |
200 |
否 |
live_to_vod_status 通知
|
名称 |
说明 |
数据类型 |
最大长度 |
可空 |
|
type |
通知类型(live_to_vod_status) |
String |
20 |
否 |
|
channel_web_id |
视频webid |
String |
100 |
否 |
|
duration |
视频时长(单位:秒) |
Integer |
10 |
是 |
|
screenshot |
视频截图(详见 截图地址拼接说明) |
String |
200 |
是 |
|
transcode_status |
参考 视频转码状态表 |
Integer |
10 |
否 |
|
live2vod_status |
直转点状态(详见 直转点状态表) |
String |
10 |
否 |
|
msg |
转码或直转点错误原因 |
String |
50 |
是 |
stream_status 通知
|
名称 |
说明 |
数据类型 |
最大长度 |
可空 |
|
type |
通知类型(stream_status) |
String |
20 |
否 |
|
channel_web_id |
视频webid |
String |
100 |
否 |
|
stream_status |
ok:推流正常,error:无直播流 |
String |
5 |
否 |
请求示例
POST /notify HTTP/1.1
Host: xxx.com
Content-Type: application/json; charset=UTF-8
Prmts-Sign: <Prmts-Sign>
{
"type":"live_status",
"channel_web_id":"0a2dnq6apaajoKqL4K2eoKmZo-ydoKuZpaih",
"live_status":"living",
"duration":0,
"screenshot":""
}
响应内容
http status 200 ok
Prmts-Sign 作为 request header 传输
Prmts-Sign 请注意兼容大小写