苏宁视频云-帮助与文档

帮助与文档点播 Server API 视频状态变更回调

视频状态变更回调

接口定义

接口描述	推送数据到CP指定URL
接口地址	CP指定URL
接口协议	HTTP POST
HTTP HEADER	Content-Type=application/json

请求参数

通知类型

vod_status:点播状态
vod_screenshot:点播截图

vod_status 通知

名称	说明	数据类型	最大长度	可空
type	通知类型(vod_status)	String	20	否
channel_web_id	视频webid	String	100	否
title	标题	String	100	否
transcode	封装状态码(参照视频转码状态表)	String	10	否
duration	视频时长(单位:秒)	Integer	10	是
screenshot	视频截图	String	200	是
msg	转码错误原因	String	50	是
current_timestamp	当前UNIX时间戳(单位:毫秒)	Integer	10	否
file_size	成片文件大小(单位:字节)	Integer	10	是
ft	成片清晰度([0-3] 清晰度依次递增)	Integer	10	是
porn_rate	鉴黄概率	DOUBLE	10	是

vod_screenshot 通知

名称	说明	数据类型	最大长度	可空
type	通知类型(vod_screenshot)	String	20	否
channel_web_id	视频webid	String	100	否
title	标题	String	100	否
screenshot	视频截图	String	200	否
current_timestamp	当前UNIX时间戳(单位:毫秒)	Integer	10	否

请求示例

POST: /callback HTTP/1.1

Host: xx.com

Content-Type: text/html; charset=UTF-8

Prmts-Sign: 7a88d5530258e32240f9280324b7c1dd


{
    "type":"vod_status",
    "channel_web_id":"0a2dnq6apaajoKqL4K2eoKmZo-ydoKuZpaih",
    "title":"vod",
    "transcode":"success",
    "duration":56,
    "screenshot":"",
    "msg":"",
    "current_timestamp": 1481766285
}

响应内容

http status 200 ok

响应示例

无

推送地址由CP提供（如：http://xxx.xxxxxx.com/callback）
苏宁视频云判断HTTP状态码为200表示接收数据成功，请求失败后最多重试3次
网络问题引起的多次发送并成功接收请CP冗余处理
Prmts-Sign 加密格式MD5(AccessKey+SecrertKey+utf8_urlencode(json字符串))

Prmts-Sign 作为 request header 传输

Prmts-Sign 请注意兼容大小写

文本导读：
接口定义
请求参数
请求示例
响应内容
响应示例