帮助与支持

1相关说明

1、回调接口是指由合作伙伴提供,我方主动去调用的接口

2、接口地址由合作伙伴提供,不同接口采用不同的地址

3、使用HTTP协议进行信息交互,参数传递采用get方式

4、字符编码统一采用UTF-8

5、返回信息支持JSON和XML两种方式

6、除了sign外,其余所有请求参数值都需要进行URL编码

7、参数表中,类型一栏声明的定义为:int 代表整数类型;string 代表字符串类型,

如果后面有括号,括号中的数字代表该参数的最大长度;array表示数组类型

2系统参数说明

名称
           
类型            必选            描述            
user_unique            string            Y            用户唯一标识码,由乐视网统一分配并提供            
timestamp            int            Y            当前Unix时间戳,请保证服务器时间正确            
format            string            Y            返回参数格式:支持json和xml两种方式            
ver            string            Y            协议版本号,统一取值为2.0            
sign            string            Y            验证码,生成规则详见下面的说明,其中secretkey是由乐视网统一分配并提供的用户密钥            


sign生成规则可以分为4个步骤:

1、把其它所有参数按key升序排序。

2、把key和它对应的value拼接成一个字符串。按步骤1中顺序,把所有键值对字符串拼接成一个字符串。

3、把分配给的secretkey拼接在第2步骤得到的字符串后面。

4、计算第3步骤字符串的md5值,使用md5值的16进制字符串作为sign的值。

3视频状态回调接口

功能描述:视频状态存在变化时,通过该接口及时告知合作伙伴

应用参数说明:

名称
           
类型            必选            描述            
video_id            int            Y            视频ID            
status            string            Y            

视频状态,有以下取值:                

UPLOAD_OVER:上传完毕                

DEAL_FAILED:转码失败                

CHECK_FAILED:审核失败                

OK:处理成功,可以正常播放                

PAUSE:视频暂停                

SOURCE_FAILED:片源错误                 

PUBLISH_FAILED:发布失败                 

UPLOAD_FAILED:上传失败                

返回参数data说明:

名称            类型            描述            
code            int            状态值:0表示操作成功;其它值表示失败,具体含义写入下面的message字段            
messagestring            

状态说明                 

4播放回调接口

功能描述:通过视频播放回调接口返回播放者关于视频播放信息(如视频播放权限、广告等,需要用户有相关权限才能生效)

应用参数说明:

名称
           
类型            必选            描述            
video_id            int            Y            视频ID            
video_unique            string            Y            视频唯一标识码            
cuid            string            Y            用户名称,由合作伙伴提供(不支持中文)            
client            string            Y            用户客户端标示,取值:pc,androidPad,h5Android,h5Ios,h5Tv,androidApp,androidTv,iosPad,iosTv,iosApp,iosPad,h5Androidpad            
utoken            string            N            

当前用户登录的token,可能从app的登录状态获取,或者www中的session中获取,可选,由合伙伙伴提供,具体含义由双方约定                

返回参数说明:

名称            类型            描述            
code            int            状态值:0表示操作成功;其它值表示失败,具体含义见message说明            
message            string            状态说明            
play_status            int            视频播放状态:0表示没有权限看视频;1.表示用户具备权限收看视频全片;2表示用户具备权限试看视频            
ad_status            string            0无广告,1正常广告逻辑