技术支持

视频管理

1.视频管理接口总体介绍

视频管理API接口主要是对现有视频进行视频信息查询、视频删除、视频上线和视频下线。(注:视频管理下的API接口都需要经过“权限验证”来获取token值)

视频管理API接口如下:

API名称 描述 实现方式 备注
IPUQXC 权限验证 HTTP
IPUJML 视频信息查询 HTTP
IPUJMD 视频删除 HTTP
IPUJMI 视频下线 HTTP
IPUJME 视频上线 HTTP

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

2.权限验证

API名称:IPUQXC
功能描述:用于生成每个视频管理API接口的token值,生成的token值在十分钟之内有效,十分钟后需要重新申请

输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPUQXC:权限验证
pReqQXC.userName string 用户名
pReqQXC.password string 用户密码 用户密码经过MD5加密后的参数(32位小写)

输出参数说明:
参数 类型 描述 取值说明
PReqQXC string 应答内容 相当XML的根目录,方便XML等格式返回
resultCode string 应答 00:受理成功
01:验证错误
02:异常错误
03:API名称错误
04:此API接口无数据返回
resultMsg string 应答描述 对返回信息进行描述
token string 令牌 其他API请求均需要此令牌。
令牌默认有效时间为10分钟。

示例:

输入
http://open.wsview.com:8090/iWSViewPortalData?bizCode=IPUQXC
&pReqQXC.userName=yu@simope.com
&pReqQXC.password=76b15fe46b5881710fd46879efc7b50e
(蓝色部分需要用户自己进行拼接,下方API接口示例同理)


输出(XML格式)
< ?xml version="1.0" encoding="UTF-8" standalone="yes"?> < PRespQXC> < resultCode>00 < resultMsg>应答描述 < token>DF4B4A129817ECFF49EBA49F108B0A7D1FE149F111CEF2A321AE755D76C97502 < /PRespQXC>

3.视频信息查询

API名称:IPUJML
功能描述:用于查询视频相关信息

输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPUJML:视频信息查询
userName string 用户名
token string 令牌 通过权限验证API获取
pReqJML.videoID string 视频ID 单个视频查询:videoID =001
多个视频查询(最多支持512个ID同时查询,多个用 “,” 英文逗号隔开,
前后均不带逗号)videoID =001,002,003
全部查询VideoID = AllList
pReqJML.videoName string 视频名称 根据视频名称进行查询,支持模糊查询;
视频ID与名称只能二选一查询;两者都填写,优先使用视频ID进行查询。

输出参数说明:
参数 类型 描述 取值说明
PRespJML string 应答内容 相当XML的根目录,方便XML等格式返回
resultCode string 应答 00:受理成功
01:验证错误
02:异常错误
03:API名称错误
04:此API接口无数据返回
resultMsg string 应答描述 对返回信息进行描述
resultCount string 记录条数
contJM object 节目信息 以列表形式返回多条记录
videoID long 视频ID
albumID long 专辑ID
videoName string 视频名称 视频名称经过MD5加密的结果
title string 标题
imagePath string 封面图片地址
imageType int 图片类型 1:视频截图
2:自定义上传
3:自定义URL(网络图片)
duration string 视频时长 时分秒格式的字符串,如:00:07:19
resolution string 源视频分辨率 如:1280x720
videoQuality int 源视频清晰度 1:基本
2:流畅
3:标清
4:高清
videoLabel string 视频标签
videoSize long 视频大小 单位:字节(Byte),如:60441312
beginDate string 视频有效开始时间
endDate string 视频有效结束时间
playerID long 播放器ID
videoStatus int 视频状态 1:错误
2:发布
3:排队
4:转码
videoView int 视频显示状态 1:上线,用户可以正常观看视频
2:下线,下线的视频将不能播放
transcodeFormat string 档位描述符 视频转码后的清晰度,如:1_720_25_H264_1000_4_3_1_0_2_1_3_0_1
_0_2_0_0_0_N(视频高度:720pix,帧率:25帧,码率:1000Kbps)
transcodeHeight string 分辨率描述符 转码后的视频高度
1_7:视频高度为720pix
1_4:视频高度为480pix
1_2:视频高度为240pix
httpStr string 连接字符 以列表形式返回多条记录。
只返回视频状态为发布的数据。
此地址可作为视频的播放地址或下载地址

示例:

输入
http://open.wsview.com:8090/iWSViewPortalData?bizCode=IPUJML
&userName=yu@simope.com &token=DF4B4A129817ECFF714F5D28C547F75904E4AFE3BFC519C8B16DB6515F3946336BF77937A9E3C5CD &pReqJML.videoID=44749


输出(XML格式)
< ?xml version="1.0" encoding="UTF-8" standalone="yes"?> < PRespJML> < resultCode>00 < resultMsg>受理成功 < resultCount>1 < contJM> < videoID>46409 < albumID>-1 < videoName>4dd7b869762eb5e5abee6b762d62ee13.mp4 < title>源视1频 < imagePath>http://img.simope.net/img/yu@simope.com/4dd7b869762eb5e5abee6b762d6
2ee13/img.jpg < imageType>1 < duration>00:02:30 < resolution>1920x1080 < videoQuality>4 < videoLabel> < videoSize>76546387 < beginDate> < endDate> < playerID>0 < videoStatus>2 < videoView>1 < transcodeFormat>1_720_25_H264_1000_4_3_1_0_2_1_3_0_1_0_2_0_0_0_N;1_480_25_H264_500_4_3
_1_0_2_1_3_0_1_0_2_0_0_0_N;1_240_25_H264_250_4_3_1_0_2_1_3_0_1_0_2_0_0_0_N;1_480_25_H264_700_4
_3_1_0_2_1_3_0_1_0_2_0_0_0_N;1_360_25_H264_400_4_3_1_0_2_1_3_0_1_0_2_0_0_0_N; < transcodeHeight>720;480;240;480;360 < httpStr>http://cdn.simope.net/mp4/yu@simope.com/4dd7b869762eb5e5abee6b762d62ee13/
1_720_25_H264_1000_4_3_1_0_2_1_3_0_1_0_2_0_0_0_N/a904effe8b6618cda0713b7d0b44d0b2.mp4 < httpStr>http://cdn.simope.net/mp4/yu@simope.com/4dd7b869762eb5e5abee6b762d62ee13/
1_480_25_H264_500_4_3_1_0_2_1_3_0_1_0_2_0_0_0_N/a94f760189ef0fff5cf1d43af06aeca7.mp4 < httpStr>http://cdn.simope.net/mp4/yu@simope.com/4dd7b869762eb5e5abee6b762d62ee13/
1_240_25_H264_250_4_3_1_0_2_1_3_0_1_0_2_0_0_0_N/7b18756c36f233f2c57d346a3b1d7c8c.mp4 < httpStr>http://cdn.simope.net/mp4/yu@simope.com/4dd7b869762eb5e5abee6b762d62ee13/
1_480_25_H264_700_4_3_1_0_2_1_3_0_1_0_2_0_0_0_N/148b496e18fc16045d892532b613691a.mp4 < httpStr>http://cdn.simope.net/mp4/yu@simope.com/4dd7b869762eb5e5abee6b762d62ee13/
1_360_25_H264_400_4_3_1_0_2_1_3_0_1_0_2_0_0_0_N/c316e5c7df68d62e81ec04bb0f01ec9c.mp4 < /contJM> < /PRespJML>

4.视频删除

API名称:IPUJMD
功能描述:用于删除视频

输入参数说明: tr>
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPUJMD:视频删除
userName string 用户名
token string 令牌 通过权限验证API获取
pReqJMD.videoID string 视频ID 单个删除:videoID =001
多个删除(最多支持512个ID同时删除,多个用 “,” 英文
逗号隔开,前后均不带逗号)videoID =001,002,003

输出参数说明:
参数 类型 描述 取值说明
PRespJMD string 应答内容 相当XML的根目录,方便XML等格式返回
resultCode string 应答 00:受理成功
01:验证错误
02:异常错误
03:API名称错误
04:此API接口无数据返回
resultMsg string 应答描述 对返回信息进行描述
resultCount string 记录条数

示例:

输入
http://open.wsview.com:8090/iWSViewPortalData?bizCode=IPUJMD
&userName=yu@simope.com &token=DF4B4A129817ECFFAFAA0E0A841962112F977161ABBB751FB16DB6515F3946336BF7937A9E3C5CD &pReqJMD.videoID=44749


输出(XML格式)
< ?xml version="1.0" encoding="UTF-8" standalone="yes"?> < PRespJMD> < resultCode>00 < resultMsg>删除成功 < resultCount>1 < /PRespJMD>

5.视频下线

API名称:IPUJMI
功能描述:下线的视频,URL地址将会失效,终端用户将不能播放视频

输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPUJMI:视频下线
userName string 用户名
token string 令牌 通过权限验证API获取
pReqJMI.videoID string 视频ID 单个视频下线:videoID =001
多个视频下线(最多支持512个ID同时下线,多个用 “,” 英文
逗号隔开,前后均不带逗号)videoID =001,002,003

输出参数说明:
参数 类型 描述 取值说明
PRespJMI string 应答内容 相当XML的根目录,方便XML等格式返回
resultCode string 应答 00:受理成功
01:验证错误
02:异常错误
03:API名称错误
04:此API接口无数据返回
resultMsg string 应答描述 对返回信息进行描述
resultCount string 记录条数

示例:

输入
http://open.wsview.com:8090/iWSViewPortalData?bizCode=IPUJMI
&userName=yu@simope.com &token=DF4B4A129817ECFFAFAA0E0A841962112F977161ABBB751FB16DB6515F3946336BF7937A9E3C5CD &pReqJMD.videoID=44749


输出(XML格式)
< ?xml version="1.0" encoding="UTF-8" standalone="yes"?> < PRespJMI> < resultCode>00 < resultMsg>视频成功下线 < resultCount>1 < /PRespJMI>

6.视频上线

API名称:IPUJME
功能描述:对下线的视频重新上线,视频将可以正常播放

输入参数说明:
参数 类型 描述 取值说明
bizCode string 接口指令的名称 IPUJME:视频上线
userName string 用户名
token string 令牌 通过权限验证API获取
pReqJMI.videoID string 视频ID 单个视频下线:videoID =001
多个视频下线(最多支持512个ID同时下线,多个用 “,” 英文
逗号隔开,前后均不带逗号)videoID =001,002,003

输出参数说明:
参数 类型 描述 取值说明
PRespJME string 应答内容 相当XML的根目录,方便XML等格式返回
resultCode string 应答 00:受理成功
01:验证错误
02:异常错误
03:API名称错误
04:此API接口无数据返回
resultMsg string 应答描述 对返回信息进行描述
resultCount string 记录条数

示例:

输入
http://open.wsview.com:8090/iWSViewPortalData?bizCode=IPUJME
&userName=yu@simope.com &token=DF4B4A129817ECFFAFAA0E0A841962112F977161ABBB751FB16DB6515F3946336BF7937A9E3C5CD &pReqJMD.videoID=44749


输出(XML格式)
< ?xml version="1.0" encoding="UTF-8" standalone="yes"?> < PRespJME> < resultCode>00 < resultMsg>视频上线 < resultCount>1 < /PRespJME>

7.特殊说明

在HTTP请求 bizCode 错误时,返回下面固定XML格式。
< ?xml version="1.0" encoding="UTF-8" standalone="yes"?> < WSViewResponse> < resultCode>03 < resultMsg>bizCode参数错误或者为空 < /WSViewResponse>

地图支持