云视频API接口文档v2.3.1云视频API接口文档v2.3.1.docx

云视频API接口文档版本：V2.3乐视网–乐视云事业部目录相关说明4请求参数说明4返回参数说明4接口说明5修订历史记录日期版本说明作者2012-06-18V1.0起草陈新2012-07-10V1.1增加xml参数返回方式；增加flash上传接口陈新2012-08-08V1.2增加数据统计类接口；增加使用示例陈新2012-09-08V2.0采用新的方式进行参数传递，改进验证码生成规则陈新2012-10-29V2.1接口地址改名；视频上传初始化和断点续传接口返回值增加progress_url；增加视频上传进度查询接口陈新2012-11-19V2.2增加截图管理类接口陈新2013-02-20V2.2增加视频暂停和恢复接口；视频上传（Flash方式）增加flash_width和flash_height参数陈新2013-4-18V2.2video.upload.flash接口增加client_ip参数张喆浩2013-04-19V2.3视频列表和视频信息接口增加file_md5参数金宗锐2013-07-25V2.3增加支持分片参数uploadtype金宗锐2014-09-15V2.3增加视频自定义截图URL地址参数金宗锐相关说明使用HTTP协议进行信息交互，字符编码统一采用UTF-8除非特殊说明，接口地址统一为：/open.php/open.php除非特殊说明，同时支持GET和POST两种参数传递方式除非特殊说明，返回信息支持JSON和XML两种方式除了sign外，其余所有请求参数值都需要进行URL编码参数表中，类型一栏声明的定义为：int 代表整数类型；string 代表字符串类型，如果后面有括号，括号中的数字代表该参数的最大长度；array表示数组类型系统参数说明名称类型必选描述user_uniquestringY用户唯一标识码，由乐视网统一分配并提供timestampintY当前Unix时间戳，请保证请求服务器时间正确，有些API接口是有时效性要求的apistringY调用API接口的名称formatstringY返回参数格式：支持json和xml两种方式verstringY协议版本号，统一取值为2.0signstringY验证码，生成规则详见下面的说明，其中secretkey是由乐视网统一分配并提供的用户密钥。sign生成规则可以分为4个步骤：把其它所有参数按key升序排序。把key和它对应的value拼接成一个字符串。按步骤1中顺序，把所有键值对字符串拼接成一个字符串。把分配给的secretkey拼接在第2步骤得到的字符串后面。计算第3步骤字符串的md5值，使用md5值的16进制字符串作为sign的值。返回参数说明名称类型描述codeint状态值：0表示操作成功；其它值表示失败，具体含义见message说明messagestring状态说明totalint符合条件的记录数量dataarray返回具体信息接口说明视频管理视频上传初始化（Web方式）api名称：video.upload.init功能描述：视频上传前调用，获取正式上传时需要的一些信息应用参数说明：名称类型必选描述video_namestring(200)Y视频名称client_ipstring(15)N用户IP地址。为了保证用户上传的速度，建议将用户公网IP地址写入该参数file_sizeintN文件大小，单位为字节uploadtypeintN是否分片上传，0不分片，1分片；默认0返回参数data说明：名称类型描述video_idint视频IDvideo_uniquestring视频唯一标识码upload_urlstring视频上传地址，视频上传时提交地址progress_urlstring视频上传进度查询地址tokenstring视频上传标识，用于断点续传和上传进度查询uploadtypeint是否分片上传，0不分片，1分片视频上传（Web方式）接口地址：由video.upload.init返回的upload_url确定功能描述：视频上传请求参数：由video.upload.init返回的upload_url确定，请不要进行任何修改返回参数data说明：名称类型描述注意事项：1、该接口只支持POST参数传递方式2、上传时form表单提交地址由video.uploadinit返回的upload_url确定，需要添加参数enctype=multipart/form-data，form表单中上传文件的参数名称为video_file示例如下：form method=post enctype=multipart/form-data action=upload_urlinput type=file name=video_file/form3、支持以下视频格式，请上传时做一下后缀