文档详情

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

发布:2017-12-17约6.85千字共13页下载文档
文本预览下载声明
云视频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、支持以下视频格式,请上传时做一下后缀
显示全部
相似文档