技术支持

上传视频

文件上传API主要是针对WEB网页形式的HTTP文件上传,此上传方式可以嵌套在第三方程序或网页(调用转码方)进行文件上传。

文件上传API为了方便网页调用,与视频管理API不同的是,文件不需要经过token权限验证,采用随机码方式;此随机码由调用方生成。返回方式采用的是JSON格式。


接口列表:

API名称 描述 实现方式 备注
IPFFUL 上传视频 HTTP
IPFFUS 文件状态查询 HTTP
IPFFEX 查询会话是否存在 HTTP 防止一个用户在多个浏览器同时上传同一个文件
IPFFCU 清除会话 HTTP 当用户点击取消按钮时需要清除会话
IPFFST 存储转码 HTTP 节目删除后,万视无忧只会从数据库删除记录,存储上仍会保留该视频源一段时间。
若要再次添加该节目,只需执行再次转码,无需重新上传

调用视频管理API接口流程图

1.上传视频


API名称:IPFFUL
功能描述:上传视频


输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPFFUL:上传视频
userName string 用户名
password string 用户密码 规则:MD5(MD5(用户密码MD5值)+随机码)
描述:用户密码MD5值(32位小写)+ randomStr值,然后再MD5加密后的结果。
randomStr string 随机码 建议用格式为yyyyMMddHHmmss(年月日时分秒)当前时间字符串。
如: 20150301122830
isPhotograph string 是否边拍边传 1 表示是边拍边传(暂未使用)
isBreakpoint string 是否断点续传 1 表示文件是续传的
0 表示文件是覆盖重传的
tranConfName string 转码配置名称 多个用 “;” 隔开,如:最后一个不要带 “ ;”
tranConfGroup string 自定义转码策略组 根据转码策略组下的参数进行转码
fileName string 文件名
fileSize string 文件大小 是指整个文件的大小,不是续传的文件大小。

输出参数说明:
参数 类型 描述 取值说明
resultCode string 应答 00:受理成功
01:验证错误
02:异常错误
03:API名称错误
04:此API接口无数据返回
resultMsg string 应答描述
videoID string 视频ID

示例:

输入
因带有file文件,无法纯参数拼接请求,此输入格式请参考P23代码示例“file.html”


输出(XML格式)
{"resultCode":"00","resultMsg":"上传成功","videoID":"45254"}

2.文件状态查询


API名称:IPFFUS
功能描述:用户查看文件是否存在以及文件大小


输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPFFUS:文件状态查询
userName string 用户名
password string 用户密码 规则:MD5(MD5(用户密码MD5值)+随机码)
描述:用户密码MD5值(32位小写)+ randomStr值,然后再MD5加密后的结果。
randomStr string 随机码 建议用格式为yyyyMMddHHmmss(年月日时分秒)当前时间字符串。
fileName string 文件名

输出参数说明:
参数 类型 描述 取值说明
resultCode string 应答 00:受理成功
01:验证错误
02:异常错误
03:API名称错误
04:此API接口无数据返回
resultMsg string 应答描述 对返回信息进行描述
videoState string 视频状态 1:存储服务器、数据库均无此视频
2:存储服务器有此视频、数据库无此视频(视频未上传完毕)
3:存储服务器无此视频、数据库有此视频(服务器上视频数据被删除)
4:存储服务器、数据库均有此视频。
videoSize string 视频大小 如果存储服务器存在此视频,则返回大小(单位字节)

示例:

输入
http://open.wsview.com:8090/iWSViewFileUpload?bizCode=IPFFUS
&userName=yu@simope.com
&password=76b15fe46b5881710fd46879efc7b50e
&randomStr=20150416114132
&fileName=测试视频.mp4


输出(XML格式)
{"resultCode":"00","resultMsg":
查询成功","videoState":"1","videoSize":"5432756"}

3.查询会话是否存在


API名称:IPFFEX
功能描述:防止用户使用多种途径上传同一视频文件


输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPFFEX:查询会话是否存在
userName string 用户名
password string 用户密码 规则:MD5(MD5(用户密码MD5值)+随机码)
描述:用户密码MD5值(32位小写)+ randomStr值,然后再MD5加密后的结果。
randomStr string 随机码 建议用格式为yyyyMMddHHmmss(年月日时分秒)当前时间字符串。
fileName string 文件名

输出参数说明:
参数 类型 描述 取值说明
uploading string true|false

示例:

输入
http://open.wsview.com:8090/iWSViewFileUpload?bizCode=IPFFEX &userName=yu@simope.com &password=76b15fe46b5881710fd46879efc7b50e &randomStr=20150432142330 &fileName=测试视频.mp4


输出(JSON格式)
{"uploading":"true"}

4.清除会话


API名称:IPFFCU
功能描述:当取消上传或上传视频完成后,需要关闭会话


输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPFFCU:清除会话
userName string 用户名
password string 用户密码 规则:MD5(MD5(用户密码MD5值)+随机码)
描述:用户密码MD5值(32位小写)+ randomStr值,然后再MD5加密后的结果。
randomStr string 随机码 建议用格式为yyyyMMddHHmmss(年月日时分秒)当前时间字符串。
fileName string 文件名

输出参数说明:
参数 类型 描述 取值说明
application string 返回SUCCESS字符

示例:

输入
http://open.wsview.com:8090/iWSViewFileUpload?bizCode=IPFFCU &userName=yu@simope.com &password=76b15fe46b5881710fd46879efc7b50e &randomStr=20150416115230 &fileName=测试视频.mp4


输出(JSON格式)
{"application":"SUCCESS"}

5.存储转码


API名称:IPFFST
功能描述:主要用于上传视频后,当用户在万视无忧后台管理页面删掉了某个文件但是存储服务器并没有删除掉。可以不用上传文件直接进行转码。


输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPFFST:存储转码
userName string 用户名
password string 用户密码 规则:MD5(MD5(用户密码MD5值)+随机码)
描述:用户密码MD5值(32位小写)+ randomStr值,然后再MD5加密后的结果。
randomStr string 随机码 建议用格式为yyyyMMddHHmmss(年月日时分秒)当前时间字符串。
fileName string 文件名
tranConfName string 转码配置名称 多个用 “;” 隔开,最后一个不要带 “ ;”
tranConfGroup string 自定义转码策略 根据转码策略组下的参数进行转码,如果 tranConfName
与tranConfGroup 都有数据,取tranConfName。
如果都没取值,文件按默认策略组进行转码。

输出参数说明:
参数 类型 描述 取值说明
resultCode string 应答 00:受理成功
01:验证错误
02:异常错误
03:API名称错误
04:此API接口无数据返回
resultMsg string 应答描述 对返回信息进行描述
videoID string 视频ID

示例:

输入
http://open.wsview.com:8090/iWSViewFileUpload?bizCode=IPFFST &userName=yu@simope.com &password=76b15fe46b5881710fd46879efc7b50e &randomStr=20150416144530 &fileName=测试视频.MP4 &tranConfName=1_240_25_H264_1000_4_3_1_0_2_1_3_0_1_0_2_0_
0_0_N;1_240_25_H264_1000_4_7_1_0_2_1_3_0_1_0_2_0_0_0_N&tranConfGroup=2
注:
1.多个tranConfName以;分割
2.此处tranConfName和tranConfGroup均有值时实际以tranConfName为准


输出(JS格式)
{"resultCode":"00","resultMsg":"转码成功","videoID":"45254"}

地图支持