Remember me
To select file, click "Choose file"
Rapidgator.net - Rapid File Hosting
Safe & Secure
RapidGator Features:
Totally free for users
Extra fast downloads
Unlimited file storage
I have read the
. And I am in agreement with it.
Your storage space is full. Delete some files or upgrade to the new .重要前提，交换机内部的帧都是会打tag的
PVID:port-based vlan id
pvid是交换机上的概念,说的是进入该端口的报文如果没有打vlan id就按pvid的值打上；
PVID是基于端口的VLAN ID，一个端口可以属于多个vlan（trunk 口），但是只能
有一个PVID（对trunk 口而言，就是native vlan；对access口而言，就是access vlan-id = pvid），
收到一个不带tag头的数据包时，会打上PVID所表示的vlan号，视同该vlan的数据包处理，所以也有人说PVID就是某个端口默认的vlan ID号
native vlan的作用之一是减轻交换机的负担，不用老是打tag，祛tag。
VID: vlan id
vid是报文上的vlan tag的意思.tag里面包含vid
在网上发现一个比较好的解释是：PVID并不是加在帧头的标记，而是端口的属性，用来标识端口接收到的未标记的帧。也就是说，当端口收到一个未标记的帧时，则把该帧转发到VID和本端口PVID相等的VLAN中去。
下图是一个有趣的情景:pc1 ping pc2的过程是这样的：·sw1的接口收到pc1的ping包，因为给他打上包含vid=10的tag，·然后在sw1的trunk因为设置了native vlan 10（亦就是PVID=10）,对该ping包拆掉进来时打的tag，不打tag的发出去，·然后到sw2的trunk口时，因为sw2在该trunk设置了native vlan 20（亦就是PVID=20），所以ping包进入后会打上vid=20的tag，·然后交换机查看 vlan 20 MAC address table，决定从连接了pc2 的access vlan 20口发出去，·但是在发出去之前，要把ping包里面的tag去掉（因为pc2无法识别还有tag的帧）。
最后附上：交换机收到帧后的处理方式
声明：本文内容由互联网用户自发贡献自行上传，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任。如果您发现有涉嫌版权的内容，欢迎发送邮件至： 进行举报，并提供相关证据，工作人员会在5个工作日内联系你，一经查实，本站将立刻删除涉嫌侵权内容。存储和 CDN
数据可视化
管理与监控
互联网中间件
域名与备案
信息流服务
存储与 CDN
管理与监控
域名与备案
服务端API文档
点播服务端API文档
1 调用方式
1.1 请求说明
1.1.1 服务地址
网易云视频点播服务使用的域名访问地址为：vcloud.163.com。
1.1.2 通信协议
网易云视频点播服务的所有接口均通过HTTPS进行通信，提供高安全性的通信通道。
重要提示：获取上传加速节点和断点续传查询断点接口除外，只支持HTTP通信。
1.1.3 请求方法
所有接口都只支持POST请求。
重要提示：获取上传加速节点和断点续传查询断点接口除外，为GET请求。
1.1.4 字符编码
所有接口均使用UTF-8编码。
1.2 公共参数
所有接口均需要放置以下公共参数在请求头中，用于标识用户和接口鉴权。后续的接口说明不再对这些参数进行说明，但每次发起请求均需要携带。
参数类型必须说明
AppKeyString是开发者平台分配的AppKey
NonceString是随机数（随机数，最大长度128个字符）
CurTimeString是当前UTC时间戳，从日0点0分0秒开始到现在的秒数
CheckSumString是服务器认证需要，SHA1(AppSecret+Nonce+CurTime)，16进制字符小写
重要提示：获取上传加速节点、文件数据上传、断点续传查询断点三个接口，不使用上述公共参数。
1.3 接口鉴权
接口通过请求头中的公共参数进行鉴权。用户通过在用户中心-&安全中心获取到的一对安全凭证进行SHA1(AppSecret+Nonce+CurTime)计算。
重要提示: 本文档中提供的所有接口均面向开发者服务器端调用，用于计算CheckSum的AppSecret开发者应妥善保管,可在应用的服务器端存储和使用，但不应存储或传递到客户端，也不应在网页等前端代码中嵌入。
计算CheckSum的java代码举例如下：
import java.security.MessageD
public class CheckSumBuilder {
public static String getCheckSum(String appSecret, String nonce, String curTime) {
return encode(&sha1&, appSecret + nonce + curTime);
private static String encode(String algorithm, String value) {
if (value == null) {
MessageDigest messageDigest = MessageDigest.getInstance(algorithm);
messageDigest.update(value.getBytes());
return getFormattedText(messageDigest.digest());
} catch (Exception e) {
throw new RuntimeException(e);
private static String getFormattedText(byte[] bytes) {
int len = bytes.
StringBuilder buf = new StringBuilder(len * 2);
for (int j = 0; j & j++) {
buf.append(HEX_DIGITS[(bytes[j] && 4) & 0x0f]);
buf.append(HEX_DIGITS[bytes[j] & 0x0f]);
return buf.toString();
private static final char[] HEX_DIGITS = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
1.4 返回说明
所有接口返回类型为JSON。返回字段如下：
名称类型说明
codeInt返回结果的状态码
retString返回的结果集
msgString当返回结果的状态码不为200时，包含的错误信息
重要提示：获取上传加速节点、文件数据上传、断点续传查询断点三个接口除外。
2 视频分类管理
2.1 创建视频分类
2.1.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/type/create
用于管理视频文件，增加分类。
2.1.2 输入参数
参数类型必须说明
typeNameString是视频分类的名称
descriptionString否视频分类的描述信息
2.1.3 输出参数
参数类型说明
codeInt状态码
typeIdInt新生成的视频分类Id
msgString错误信息
2.1.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
2.1.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d'{&typeName&:&movie&,&description&:&电影&}' https://vcloud.163.com/app/vod/type/create
&typeId& : 1
&code& : 200
2.2 获取视频分类
2.2.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/type/get
获取单个视频分类信息，包括：Id、分类描述信息、分类数目和分类的创建时间。
2.2.2 输入参数
参数类型必须说明
typeIdInt是视频分类的Id
2.2.3 输出参数
参数类型说明
codeInt状态码
typeIdInt视频分类Id
typeNameString视频分类的名称
descString视频分类的描述信息
numberInt该类别下的视频文件数量
isDelInt是否允许被删除（默认分类不允许删除），1：允许，0：不允许
createTimeInt视频分类的创建时间（单位：毫秒）
msgString错误信息
2.2.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
2.2.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&typeId&:227}' https://vcloud.163.com/app/vod/type/get
&typeName&: &movie&,
&createTime&: 9,
&isDel&: 1,
&desc&: &电影&,
&number&: 0,
&typeId&: 227
&code&: 200
2.3 获取视频分类列表
2.3.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/type/list
获取视频分类列表，并做分页返回处理。单个视频的分类信息包括：Id、分类描述信息、分类数目和分类的创建时间。
2.3.2 输入参数
参数类型必须说明
currentPageInt是获取视频分类列表分页后的索引
pageSizeInt是获取视频分类列表一页的记录数（若为-1，表示不用分页）
2.3.3 输出参数
参数类型说明
codeInt状态码
currentPageInt当前取得页数
pageSizeInt一页的记录数目
pageNumInt总页数
totalRecordsInt获取视频分类列表的分类数目
listList获取的视频分类列表
list.typeIdInt视频分类Id
list.typeNameString视频分类的名称
list.descString视频分类的描述信息
list.numberInt该类别下的视频文件数量
list.isDelInt是否允许被删除（默认分类不允许删除），1：允许，0：不允许
list.createTimeInt视频分类的创建时间（单位：毫秒）
2.3.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
2.3.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&currentPage&:1,&pageSize&:2}' https://vcloud.163.com/app/vod/type/list
&pageSize&: 2,
&totalRecords&: 4,
&typeName&: &默认分类&,
&createTime&: 0,
&isDel&: 0,
&desc&: &默认分类&,
&number&: 47,
&typeId&: 38
&typeName&: &直播录制&,
&createTime&: 0,
&isDel&: 0,
&desc&: &直播录制&,
&number&: 1,
&typeId&: 39
&currentPage&: 1,
&pageNum&: 2
&code&: 200
2.4 修改视频分类
2.4.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/type/update
用于管理视频文件，修改分类，可修改：分类名称、分类描述信息。
2.4.2 输入参数
参数类型必须说明
typeIdInt是视频分类的Id
typeNameString是视频分类的名称
descriptionString否视频分类的描述信息
2.4.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
2.4.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
2.4.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&typeId&:227, &typeName&:&娱乐&,&description&:&更改分类&}' https://vcloud.163.com/app/vod/type/update
&ret&: {},
&code&: 200
2.5 删除视频分类
2.5.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/type/typeDelete
删除视频分类。
2.5.2 输入参数
参数类型必须说明
typeIdInt是视频分类Id
2.5.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
2.5.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
2.5.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&typeId&:227}' https://vcloud.163.com/app/vod/type/typeDelete
&ret&: {},
&code&: 200
2.6 设置视频的分类
2.6.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/type/set
设置视频的分类。
2.6.2 输入参数
参数类型必须说明
vidInt是视频Id
typeIdInt是视频分类的Id
2.6.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
2.6.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
2.6.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:12,&typeId&:227}' https://vcloud.163.com/app/vod/type/set
&ret&: {},
&code&: 200
3 视频转码模板管理
3.1 创建视频转码模板
3.1.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/preset/create
用于视频文件转码，增加模板。
3.1.2 输入参数
参数类型必须说明
presetNameString是视频转码模板的名称
sdMp4Int是流畅Mp4格式（1表示选择，0表示不选择）
hdMp4Int是标清Mp4格式（1表示选择，0表示不选择）
shdMp4Int是高清Mp4格式（1表示选择，0表示不选择）
sdFlvInt是流畅Flv格式（1表示选择，0表示不选择）
hdFlvInt是标清Flv格式（1表示选择，0表示不选择）
shdFlvInt是高清Flv格式（1表示选择，0表示不选择）
sdHlsInt是流畅Hls格式（1表示选择，0表示不选择）
hdHlsInt是标清Hls格式（1表示选择，0表示不选择）
shdHlsInt是高清Hls格式（1表示选择，0表示不选择）
3.1.3 输出参数
参数类型说明
codeInt状态码
presetIdInt新生成的视频转码模板Id
msgString错误信息
3.1.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
3.1.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d'{&presetName&:&全高清&,&sdMp4&:0,&hdMp4&:1,&shdMp4&:0,&sdFlv&:0,&hdFlv&:1,&shdFlv&:0,&sdHls&:0,&hdHls&:1,&shdHls&:0}' https://vcloud.163.com/app/vod/preset/create
&presetId&: 184
&code&: 200
3.2 获取视频转码模板
3.2.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/preset/get
获取单个视频转码模板信息，包括：Id、视频转码模板名称、视频转码模板对应的格式。
3.2.2 输入参数
参数类型必须说明
presetIdInt是视频转码模板Id
3.2.3 输出参数
参数类型说明
codeInt状态码
presetNameString视频转码模板的名称
sdMp4Int流畅Mp4格式（1表示包含，0表示不包含）
hdMp4Int标清Mp4格式（1表示包含，0表示不包含）
shdMp4Int高清Mp4格式（1表示包含，0表示不包含）
sdFlvInt流畅Flv格式（1表示包含，0表示不包含）
hdFlvInt标清Flv格式（1表示包含，0表示不包含）
shdFlvInt高清Flv格式（1表示包含，0表示不包含）
sdHlsInt流畅Hls格式（1表示包含，0表示不包含）
hdHlsInt标清Hls格式（1表示包含，0表示不包含）
shdHlsInt高清Hls格式（1表示包含，0表示不包含）
isDelInt是否允许被删除（默认模板不允许删除），1：允许，0：不允许
msgString错误信息
3.2.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
3.2.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&presetId&:184}' https://vcloud.163.com/app/vod/preset/get
&sdHls&: 0,
&isDel&: 1,
&shdHls&: 0,
&hdHls&: 1,
&presetId&: 184,
&sdMp4&: 0,
&sdFlv&: 0,
&shdMp4&: 0,
&shdFlv&: 0,
&presetName&: &全高清&,
&hdFlv&: 1,
&hdMp4&: 1
&code&: 200
3.3 获取视频转码模板列表
3.3.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/preset/list
获取视频转码模板列表，并做分页返回处理。单个视频转码模板的信息包括：Id、视频转码模板名称、视频转码模板对应的格式。
3.3.2 输入参数
参数类型必须说明
currentPageInt是获取视频转码模板列表分页后的索引
pageSizeInt是获取视频转码模板列表一页的记录数（若为-1，表示不用分页）
3.3.3 输出参数
参数类型说明
codeInt状态码
currentPageInt当前取得页数
pageSizeInt一页的记录数目
pageNumInt总页数
totalRecordsInt获取视频转码模板列表的数目
listList获取的视频转码模板列表
list.presetIdInt视频转码模板Id
list.presetNameString视频转码模板的名称
list.sdMp4Int流畅Mp4格式（1表示包含，0表示不包含）
list.hdMp4Int标清Mp4格式（1表示包含，0表示不包含）
list.shdMp4Int高清Mp4格式（1表示包含，0表示不包含）
list.sdFlvInt流畅Flv格式（1表示包含，0表示不包含）
list.hdFlvInt标清Flv格式（1表示包含，0表示不包含）
list.shdFlvInt高清Flv格式（1表示包含，0表示不包含）
list.sdHlsInt流畅Hls格式（1表示包含，0表示不包含）
list.hdHlsInt标清Hls格式（1表示包含，0表示不包含）
list.shdHlsInt高清Hls格式（1表示包含，0表示不包含）
list.isDelInt是否允许被删除（默认模板不允许删除），1：允许，0：不允许
3.3.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
3.3.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&currentPage&:1,&pageSize&:2}' https://vcloud.163.com/app/vod/preset/list
&pageSize&: 2,
&totalRecords&: 8,
&sdHls&: 0,
&isDel&: 0,
&shdHls&: 0,
&hdHls&: 0,
&presetId&: 39,
&sdMp4&: 0,
&sdFlv&: 0,
&shdMp4&: 0,
&shdFlv&: 0,
&presetName&: &默认模板&,
&hdFlv&: 0,
&hdMp4&: 0
&sdHls&: 0,
&isDel&: 1,
&shdHls&: 0,
&hdHls&: 0,
&presetId&: 40,
&sdMp4&: 1,
&sdFlv&: 1,
&shdMp4&: 0,
&shdFlv&: 0,
&presetName&: &dd&,
&hdFlv&: 0,
&hdMp4&: 0
&currentPage&: 1,
&pageNum&: 4
&code&: 200
3.4 修改视频转码模板
3.4.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/preset/update
用于视频文件转码，修改转码模板，可修改：视频转码模板名称、视频转码模板对应的格式。
3.4.2 输入参数
参数类型必须说明
presetIdInt是视频转码模板的Id
presetNameString是视频转码模板的名称
sdMp4Int是流畅Mp4格式（1表示选择，0表示不选择）
hdMp4Int是标清Mp4格式（1表示选择，0表示不选择）
shdMp4Int是高清Mp4格式（1表示选择，0表示不选择）
sdFlvInt是流畅Flv格式（1表示选择，0表示不选择）
hdFlvInt是标清Flv格式（1表示选择，0表示不选择）
shdFlvInt是高清Flv格式（1表示选择，0表示不选择）
sdHlsInt是流畅Hls格式（1表示选择，0表示不选择）
hdHlsInt是标清Hls格式（1表示选择，0表示不选择）
shdHlsInt是高清Hls格式（1表示选择，0表示不选择）
3.4.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
3.4.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
3.4.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&presetId&:184,&presetName&:&全转码&,&sdMp4&:1,&hdMp4&:1,&shdMp4&:1,&sdFlv&:1,&hdFlv&:1,&shdFlv&:1,&sdHls&:1,&hdHls&:1,&shdHls&:1}' https://vcloud.163.com/app/vod/preset/update
&ret&: {},
&code&: 200
3.5 删除视频转码模板
3.5.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/preset/presetDelete
删除视频转码模板。
3.5.2 输入参数
参数类型必须说明
presetIdInt是视频转码模板Id
3.5.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
3.5.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
3.5.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&presetId&:184}' https://vcloud.163.com/app/vod/preset/presetDelete
&ret&: {},
&code&: 200
4 视频水印管理
4.1 创建视频水印模板
4.1.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/watermark/create
用于视频文件管理水印，增加水印模板。
4.1.2 输入参数
参数类型必须说明
watermarkNameString是视频水印的名称
imageIdInt是视频水印图片的Id
descriptionString否视频水印的描述信息
coordinateString否视频水印左上角的坐标，其值为相对值，比如：8%_6%表示在视频左上角的偏右8%视频宽度、偏下6%视频高度的位置。如果不选填，默认设置为5%_5%
scaleString否视频水印的长宽，其值为相对值，比如：10%x15%表示长为视频宽度的10%，宽为视频宽度的15%。如果不选填，默认设置为不缩放或拉伸
重要提示：不建议设置水印的scale参数，缩放或拉伸水印图片会影响水印图片的效果，可能会出现模糊现象。
4.1.3 输出参数
参数类型说明
codeInt状态码
watermarkIdInt视频水印Id
msgString错误信息
4.1.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
4.1.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d'{&watermarkName&:&梅花水印&,&imageId&:1,&description&:&梅花水印&,&coordinate&:&8%_6%&}' https://vcloud.163.com/app/vod/watermark/create
&watermarkId&: 16
&code&: 200
4.2 获取视频水印模板
4.2.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/watermark/get
获取单个视频水印模板信息，包括：Id、视频水印模板名称、视频水印模板对应的配置参数。
4.2.2 输入参数
参数类型必须说明
watermarkIdInt是视频水印模板Id
4.2.3 输出参数
参数类型说明
codeInt状态码
watermarkIdInt视频水印模板Id
watermarkNameString视频水印模板的名称
descriptionString视频水印的描述信息
coordinateString视频水印左上角的坐标，其值为相对值，比如：8%_6%表示在视频左上角的偏右8%视频宽度、偏下6%视频高度的位置。如果不选填，默认设置为5%_5%
scaleString视频水印的长宽，其值为相对值，比如：10%x15%表示长为视频宽度的10%，宽为视频宽度的15%。如果不选填，默认设置为不缩放或拉伸
imageIdInt水印图片Id
imageUrlString水印图片URL
isDelInt是否允许被删除（默认水印不允许删除），1:允许，0:不允许
msgString错误信息
4.2.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
4.2.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&watermarkId&:16}' https://vcloud.163.com/app/vod/watermark/get
&scale&: null,
&watermarkName&: &梅花水印&,
&coordinate&: &8%_6%&,
&description&: &梅花水印&,
&watermarkId&: 16,
&imageId&: 21,
&imageUrl&: &http://vodk32ywxdf.nosdn.127.net/fda0bee8-6b96-45e4-acc8a.jpg&,
&isDel&: 1
&code&: 200
4.3 获取视频水印模板列表
4.3.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/watermark/list
获取视频水印模板列表，并做分页返回处理。单个视频水印模板的信息包括：Id、视频水印模板名称、视频水印模板对应的配置参数。
4.3.2 输入参数
参数类型必须说明
currentPageInt是获取视频水印模板列表分页后的索引
pageSizeInt是获取视频水印模板列表一页的记录数（若为-1，表示不用分页）
4.3.3 输出参数
参数类型说明
codeInt状态码
currentPageInt当前取得页数
pageSizeInt一页的记录数目
pageNumInt总页数
totalRecordsInt获取视频水印转码模板列表的分类数目
listList获取的视频水印模板列表
list.watermarkIdInt视频水印模板Id
list.watermarkNameString视频水印模板的名称
list.descriptionString视频水印的描述信息
list.coordinateString视频水印左上角的坐标，其值为相对值，比如：8%_6%表示在视频左上角的偏右8%视频宽度、偏下6%视频高度的位置。如果不选填，默认设置为5%_5%
list.scaleString视频水印的长宽，其值为相对值，比如：10%x15%表示长为视频宽度的10%，宽为视频宽度的15%。如果不选填，默认设置为不缩放或拉伸
list.imageIdInt水印图片Id
list.imageUrlString水印图片URL
list.isDelInt是否允许被删除（默认水印不允许删除），1:允许，0:不允许
4.3.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
4.3.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&currentPage&:1,&pageSize&:2}' https://vcloud.163.com/app/vod/watermark/list
&pageSize&: 2,
&totalRecords&: 9,
&scale&: &10%x15%&,
&watermarkName&: &小熊水印&,
&coordinate&: &20%_12%&,
&description&: &ss&,
&watermarkId&: 6,
&imageId&: 21,
&imageUrl&: &http://vodk32ywxdf.nosdn.127.net/fda0bee8-6b96-45e4-acc8a.jpg&,
&isDel&: 1
&scale&: &10%x15%&,
&watermarkName&: &royen_test&,
&coordinate&: &5%_5%&,
&description&: null,
&watermarkId&: 7,
&imageId&: 21,
&imageUrl&: &http://vodk32ywxdf.nosdn.127.net/fda0bee8-6b96-45e4-acc8a.jpg&,
&isDel&: 1
&currentPage&: 1,
&pageNum&: 5
&code&: 200
4.4 修改视频水印模板
4.4.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/watermark/update
用于修改水印模板，可修改：视频转码模板名称、视频转码模板对应的格式。
4.4.2 输入参数
参数类型必须说明
watermarkIdInt是视频水印模板Id
watermarkNameString是视频水印的名称
descriptionString否视频水印的描述信息
coordinateString否视频水印左上角的坐标，其值为相对值，比如：8%_6%表示在视频左上角的偏右8%视频宽度、偏下6%视频高度的位置。如果不选填，默认设置为5%_5%
scaleString否视频水印的长宽，其值为相对值，比如：10%x15%表示长为视频宽度的10%，宽为视频宽度的15%。如果不选填，默认设置为不缩放或拉伸
imageIdInt否水印图片Id
4.4.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
4.4.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
4.4.5 示例
curl -X POST-H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&watermarkId&:6,&watermarkName&:&haha&,&coordinate&:&20%_20%&}' https://vcloud.163.com/app/vod/watermark/update
&ret&: {},
&code&: 200
4.5 删除视频水印模板
4.5.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/watermark/delete
删除水印模板。
4.5.2 输入参数
参数类型必须说明
watermarkIdInt是视频水印模板Id
4.5.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
4.5.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
4.5.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&watermarkId&:6}' https://vcloud.163.com/app/vod/watermark/delete
&ret&: {},
&code&: 200
5 视频文件管理
5.1 获取视频文件信息
5.1.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/get
获取单个视频文件信息，包括：Id、视频名称、各个视频格式的播放地址、各个视频格式的下载地址、各个视频格式的视频大小、视频截图地址、视频所属分类Id和名称、视频播放时长、视频转码完成时间。
5.1.2 输入参数
参数类型必须说明
vidInt是视频Id
5.1.3 输出参数
参数类型说明
codeInt状态码
videoNameString视频的名称
statusInt视频的状态，10表示初始，20表示失败，30表示处理中，40表示成功，50表示屏蔽
descriptionString视频的描述信息
completeTimeInt转码完成时间
durationInt视频播放时长（单位：秒）
durationMsecInt视频播放时长（单位：毫秒）
widthString视频宽度，默认为&0&
heightString视频高度，默认为&0&
typeIdInt视频所属分类Id
typeNameString视频所属分类名称
snapshotUrlString视频封面截图URL地址
origUrlString原始视频的播放地址
downloadOrigUrlString原始视频的下载地址
initialSizeInt原始视频文件大小（单位：字节）
sdMp4UrlString标清Mp4视频格式文件播放地址
downloadSdMp4UrlString标清Mp4视频格式文件下载地址
sdMp4SizeInt标清Mp4视频格式文件的大小（单位：字节）
sdMp4WidthString标清Mp4视频宽度，默认为&0&
sdMp4HeightString标清Mp4视频高度，默认为&0&
hdMp4UrlString高清Mp4视频格式文件播放地址
downloadHdMp4UrlString高清Mp4视频格式文件下载地址
hdMp4SizeInt高清Mp4视频格式文件的大小（单位：字节）
hdMp4WidthString高清Mp4视频宽度，默认为&0&
hdMp4HeightString高清Mp4视频高度度，默认为&0&
shdMp4UrlString超清Mp4视频格式文件播放地址
downloadShdMp4UrlString超清Mp4视频格式文件下载地址
shdMp4SizeInt超清Mp4视频格式文件的大小（单位：字节）
shdMp4WidthString超清Mp4视频宽度，默认为&0&
shdMp4HeightString超清Mp4视频高度，默认为&0&
sdFlvUrlString标清Flv视频格式文件播放地址
downloadSdFlvUrlString标清Flv视频格式文件下载地址
sdFlvSizeInt标清Flv视频格式文件的大小（单位：字节）
sdFlvWidthString标清Flv视频宽度，默认为&0&
sdFlvHeightString标清Flv视频高度，默认为&0&
hdFlvUrlString高清Flv视频格式文件播放地址
downloadHdFlvUrlString高清Flv视频格式文件下载地址
hdFlvSizeInt高清Flv视频格式文件的大小（单位：字节）
hdFlvWidthString高清Flv视频宽度，默认为&0&
hdFlvHeightString高清Flv视频高度，默认为&0&
shdFlvUrlString超清Flv视频格式文件播放地址
downloadShdFlvUrlString超清Flv视频格式文件下载地址
shdFlvSizeInt超清Flv视频格式文件的大小（单位：字节）
shdFlvWidthString超清Flv视频宽度，默认为&0&
shdFlvHeightString超清Flv视频高度，默认为&0&
sdHlsUrlString标清Hls视频格式文件播放地址
downloadSdHlsUrlString标清Hls视频格式文件下载地址
sdHlsSizeInt标清Hls视频格式文件的大小（单位：字节）
sdHlsWidthString标清Hls视频宽度，默认为&0&
sdHlsHeightString标清Hls视频高度，默认为&0&
hdHlsUrlString高清Hls视频格式文件播放地址
downloadHdHlsUrlString高清Hls视频格式文件下载地址
hdHlsSizeInt高清Hls视频格式文件的大小（单位：字节）
hdHlsWidthString高清Hls视频宽度，默认为&0&
hdHlsHeightString高清Hls视频高度，默认为&0&
shdHlsUrlString超清Hls视频格式文件播放地址
downloadShdHlsUrlString超清Hls视频格式文件下载地址
shdHlsSizeInt超清Hls视频格式文件的大小（单位：字节）
shdHlsWidthString超清Hls视频宽度，默认为&0&
shdHlsHeightString超清Hls视频高度，默认为&0&
createTimeInt视频上传时间（单位：毫秒）
updateTimeInt视频更新时间（单位：毫秒）
msgString错误信息
5.1.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
5.1.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:32}' https://vcloud.163.com/app/vod/video/get
&createTime&: 9,
&origUrl&: &http://vodk32ywxdf.vod.126.net/vodk32ywxdf/44d-4b2f-82c8-154dbb6b4e14.mp4&,
&downloadOrigUrl&: &http://vodk32ywxdf.nosdn.127.net/44d-4b2f-82c8-154dbb6b4e14.mp4?NOSAccessKeyId=abe1b8e5ee&Expires=&download=watermark_test_1.mp4&Signature=%2BGu%2BvgiUP1rL4pbx%2B52GH4QCo%2FOHAtlhgzCzPV9f0vc%3D&,
&shdMp4Url&: &http://vodk32ywxdf.vod.126.net/vodk32ywxdf/nos/mp4//v32_shd.mp4&,
&sdMp4Size&: ,
&videoName&: &watermark_test_1&,
&downloadSdMp4Url&: &http://vodk32ywxdf.nosdn.127.net/nos%2Fmp4%2F%2F22%2Fv32_sd.mp4?NOSAccessKeyId=abe1b8e5ee&Expires=&download=%25E6%25A0%%25B8%2585_watermark_test_1.mp4&Signature=64FOWYzLciWyTe8hmLMRVCYRCsQLbEOWtNqcB9rUj18%3D&,
&description&: null,
&hdMp4Size&: ,
&downloadSdFlvUrl&: &http://vodk32ywxdf.nosdn.127.net/nos%2Fflv%2F%2F22%2Fv32_sd.flv?NOSAccessKeyId=abe1b8e5ee&Expires=&download=%25E6%25A0%%25B8%2585_watermark_test_1.flv&Signature=pGmKYIjWq%2FZE9Gu8K1MZcuqQYG83cI2bnuiikLO8TCk%3D&,
&vid&: 32,
&shdMp4Size&: ,
&sdFlvUrl&: &http://vodk32ywxdf.vod.126.net/vodk32ywxdf/nos/flv//v32_sd.flv&,
&sdFlvSize&: ,
&hdMp4Url&: &http://vodk32ywxdf.vod.126.net/vodk32ywxdf/nos/mp4//v32_hd.mp4&,
&status&: 40,
&updateTime&: 2,
&sdMp4Url&: &http://vodk32ywxdf.vod.126.net/vodk32ywxdf/nos/mp4//v32_sd.mp4&,
&downloadHdMp4Url&: &http://vodk32ywxdf.nosdn.127.net/nos%2Fmp4%2F%2F22%2Fv32_hd.mp4?NOSAccessKeyId=abe1b8e5ee&Expires=&download=%25E9%25AB%%25B8%2585_watermark_test_1.mp4&Signature=kMUKJGcW8aSFauL2836pXA5UrEeowq2hLdpgMpjmr44%3D&,
&downloadShdMp4Url&: &http://vodk32ywxdf.nosdn.127.net/nos%2Fmp4%2F%2F22%2Fv32_shd.mp4?NOSAccessKeyId=abe1b8e5ee&Expires=&download=%25E8%25B6%%25B8%2585_watermark_test_1.mp4&Signature=ch30%2BtX20b54UeskhFZs37r55jkt2WIV87jlaZgKmPY%3D&,
&typeName&: &默认分类&,
&duration&: 195,
&snapshotUrl&: &http://vodk32ywxdf.nosdn.127.net/6c4a9501-ee3c-4e00-9a5f-20f.jpg&,
&initialSize&: ,
&typeId&: 38,
&completeTime&: 2
&code&: 200
5.2 获取视频文件信息列表
5.2.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/list
获取视频转码模板列表，并做分页返回处理。单个视频转码模板的信息包括：Id、视频转码模板名称、视频转码模板对应的格式。
5.2.2 输入参数
参数类型必须说明
currentPageInt是获取视频列表分页后的索引
pageSizeInt是获取视频列表一页的记录数（若为-1，表示不用分页）
statusInt是根据视频状态过滤选择（0表示获取所有状态视频，10表示初始，20表示失败，30表示处理中，40表示成功，50表示屏蔽）
typeInt是根据视频分类过滤选择（0表示获取所有分类视频）
5.2.3 输出参数
参数类型说明
codeInt状态码
currentPageInt当前取得页数
pageSizeInt一页的记录数目
pageNumInt总页数
totalRecordsInt获取视频列表的分类数目
listList获取的视频列表
list.videoNameString视频的名称
list.statusInt视频的状态，10表示初始，20表示失败，30表示处理中，40表示成功，50表示屏蔽
list.descriptionString视频的描述信息
list.completeTimeInt转码完成时间
list.durationInt视频播放时长（单位：秒）
list.durationMsecInt视频播放时长（单位：毫秒）
list.widthString视频宽度，默认为&0&
list.heightString视频高度，默认为&0&
list.typeIdInt视频所属分类Id
list.typeNameString视频所属分类名称
list.snapshotUrlString视频封面截图URL地址
list.origUrlString原始视频的播放地址
list.downloadOrigUrlString原始视频的下载地址
list.initialSizeInt原始视频文件大小（单位：字节）
list.sdMp4UrlString标清Mp4视频格式文件播放地址
list.downloadSdMp4UrlString标清Mp4视频格式文件下载地址
list.sdMp4SizeInt标清Mp4视频格式文件的大小（单位：字节）
list.sdMp4WidthString标清Mp4视频宽度，默认为&0&
list.sdMp4HeightString标清Mp4视频高度，默认为&0&
list.hdMp4UrlString高清Mp4视频格式文件播放地址
list.downloadHdMp4UrlString高清Mp4视频格式文件下载地址
list.hdMp4SizeInt高清Mp4视频格式文件的大小（单位：字节）
list.hdMp4WidthString高清Mp4视频宽度，默认为&0&
list.hdMp4HeightString高清Mp4视频高度，默认为&0&
list.shdMp4UrlString超清Mp4视频格式文件播放地址
list.downloadShdMp4UrlString超清Mp4视频格式文件下载地址
list.shdMp4SizeInt超清Mp4视频格式文件的大小（单位：字节）
list.shdMp4WidthString超清Mp4视频宽度，默认为&0&
list.shdMp4HeightString超清Mp4视频高度，默认为&0&
list.sdFlvUrlString标清Flv视频格式文件播放地址
list.downloadSdFlvUrlString标清Flv视频格式文件下载地址
list.sdFlvSizeInt标清Flv视频格式文件的大小（单位：字节）
list.sdFlvWidthString标清Flv视频宽度，默认为&0&
list.sdFlvHeightString标清Flv视频高度，默认为&0&
list.hdFlvUrlString高清Flv视频格式文件播放地址
list.downloadHdFlvUrlString高清Flv视频格式文件下载地址
list.hdFlvSizeInt高清Flv视频格式文件的大小（单位：字节）
list.hdFlvWidthString高清Flv视频宽度，默认为&0&
list.hdFlvHeightString高清Flv视频高度，默认为&0&
list.shdFlvUrlString超清Flv视频格式文件播放地址
list.downloadShdFlvUrlString超清Flv视频格式文件下载地址
list.shdFlvSizeInt超清Flv视频格式文件的大小（单位：字节）
list.shdFlvWidthString超清Flv视频宽度，默认为&0&
list.shdFlvHeightString超清Flv视频高度，默认为&0&
list.sdHlsUrlString标清Hls视频格式文件播放地址
list.downloadSdHlsUrlString标清Hls视频格式文件下载地址
list.sdHlsSizeInt标清Hls视频格式文件的大小（单位：字节）
list.sdHlsWidthString标清Hls视频宽度，默认为&0&
list.sdHlsHeightString标清Hls视频高度，默认为&0&
list.hdHlsUrlString高清Hls视频格式文件播放地址
list.downloadHdHlsUrlString高清Hls视频格式文件下载地址
list.hdHlsSizeInt高清Hls视频格式文件的大小（单位：字节）
list.hdHlsWidthString高清Hls视频宽度，默认为&0&
list.hdHlsHeightString高清Hls视频高度，默认为&0&
list.shdHlsUrlString超清Hls视频格式文件播放地址
list.downloadShdHlsUrlString超清Hls视频格式文件下载地址
list.shdHlsSizeInt超清Hls视频格式文件的大小（单位：字节）
list.shdHlsWidthString超清Hls视频宽度，默认为&0&
list.shdHlsHeightString超清Hls视频高度，默认为&0&
list.createTimeInt视频上传时间（单位：毫秒）
list.updateTimeInt视频更新时间（单位：毫秒）
5.2.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
5.2.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&currentPage&:1,&pageSize&:2,&status&:0,&type&:0}' https://vcloud.163.com/app/vod/video/list
&pageSize&: 2,
&totalRecords&: 28,
&typeName&: &默认分类&,
&createTime&: 8,
&duration&: 0,
&origUrl&: &http://vodk32ywxdf.vod.126.net/vodk32ywxdf/02a32b58-39fa-4d04-aeca-d7defa7e8972.jpg&,
&downloadOrigUrl&: &http://vodk32ywxdf.nosdn.127.net/02a32b58-39fa-4d04-aeca-d7defa7e8972.jpg?NOSAccessKeyId=abe1b8e5ee&Expires=&download=qwqwqw.jpg&Signature=0b5yMclktt%2FpDBQIZU8bLB6suouXLMfGZhqECFDp8%2Bw%3D&,
&status&: 40,
&updateTime&: 8,
&description&: null,
&snapshotUrl&: null,
&initialSize&: 6354,
&videoName&: &qwqwqw&,
&typeId&: 38,
&completeTime&: null,
&typeName&: &默认分类&,
&createTime&: 6,
&duration&: 0,
&origUrl&: &http://vodk32ywxdf.vod.126.net/vodk32ywxdf/dcffdc0d--8d30-d1df.jpg&,
&downloadOrigUrl&: &http://vodk32ywxdf.nosdn.127.net/dcffdc0d--8d30-d1df.jpg?NOSAccessKeyId=abe1b8e5ee&Expires=&download=Chrysanthemum.jpg&Signature=oxa5%2F60xl8dmhtLoS21p97J%2BrnsRWFP12c30oA6Sh3o%3D&,
&status&: 40,
&updateTime&: 6,
&description&: null,
&snapshotUrl&: null,
&initialSize&: 879394,
&videoName&: &Chrysanthemum&,
&typeId&: 38,
&completeTime&: null,
&currentPage&: 1,
&pageNum&: 14
&code&: 200
5.3 视频文件信息编辑
5.3.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/edit
用于视频文件信息管理，修改视频文件信息，可修改：视频文件名称、视频分类Id和视频描述信息。
5.3.2 输入参数
参数类型必须说明
vidInt是视频Id
videoNameString是视频的名称
typeIdInt是视频分类Id
descriptionString否视频的描述信息
5.3.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
5.3.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
5.3.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:20,&videoName&:&for_love.mp4&,&typeId&:20,&description&:&编辑视频&}' https://vcloud.163.com/app/vod/video/edit
&ret&: {},
&code&: 200
5.4 删除单个转码输出视频
5.4.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/delete_single
用于视频管理，删除单个转码输出视频（不允许删除单个源视频）。
5.4.2 输入参数
参数类型必须说明
vidInt是视频Id
styleInt是视频转码格式（1表示标清mp4，2表示高清mp4，3表示超清mp4，4表示标清flv，5表示高清flv，6表示超清flv，7表示标清hls，8表示高清hls，9表示超清hls）
5.4.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
5.4.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
5.4.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:32,&style&:3}' https://vcloud.163.com/app/vod/video/delete_single
&ret&: {},
&code&: 200
5.5 删除视频文件
5.5.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/videoDelete
用于视频管理，删除视频文件。
5.5.2 输入参数
参数类型必须说明
vidInt是视频Id
5.5.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
5.5.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
5.5.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:32}' https://vcloud.163.com/app/vod/video/videoDelete
&ret&: {},
&code&: 200
5.6 视频屏蔽
5.6.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/videoDisable
用于视频管理，屏蔽视频文件（只有正常状态下的视频才能做屏蔽操作）。
5.6.2 输入参数
参数类型必须说明
vidInt是视频Id
5.6.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
5.6.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
5.6.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:35}' https://vcloud.163.com/app/vod/video/videoDisable
&ret&: {},
&code&: 200
5.7 视频恢复
5.7.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/videoRecover
用于视频管理，恢复视频文件（只有被屏蔽的视频才能做恢复操作）。
5.7.2 输入参数
参数类型必须说明
vidInt是视频Id
5.7.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
5.7.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
5.7.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:35}' https://vcloud.163.com/app/vod/video/videoRecover
&ret&: {},
&code&: 200
5.8 批量删除视频
5.8.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/delete
用于视频管理，批量删除视频文件。
5.8.2 输入参数
参数类型必须说明
vidsList是多个视频ID组成的列表
5.8.3 输出参数
参数类型说明
codeInt错误码
msgString错误信息
5.8.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
711请求参数非法，具体信息见msg
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
724部分删除操作成功
5.8.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vids&:[20]}' https://vcloud.163.com/app/vod/video/delete
&Content-Type&: &application/ charset=utf-8&
&code& : 200,
&msg& : &&
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vids&:[20,21,23,24]}' https://vcloud.163.com/app/vod/video/delete
&Content-Type&: &application/ charset=utf-8&
&code& : 724,
&failedVids& : [23,24]
code参考code状态表
6 文件上传
6.1 文件上传初始化
6.1.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/upload/init
用于文件上传的初始化，获取xNosToken（上传凭证）、bucket（存储对象的桶名）、object（生成的唯一对象名）。
6.1.2 输入参数
参数类型必须说明
originFileNameString是上传文件的原始名称（包含后缀名）
userFileNameString否用户命名的上传文件名称
typeIdInt否视频所属的类别Id（不填写为默认分类）
presetIdInt否视频所需转码模板Id（不填写为默认模板，默认模板不进行转码）
uploadCallbackUrlString否上传成功后回调客户端的URL地址（需标准http格式）
callbackUrlString否转码成功后回调客户端的URL地址（需标准http格式）
descriptionString否上传视频的描述信息
watermarkIdInt否视频水印Id（不填写为不添加水印，如果选择，请务必在水印管理中提前完成水印图片的上传和参数的配置；且必需设置prestId字段，且presetId字段不为默认模板）
userDefInfoString否用户自定义信息，回调会返回此信息
6.1.3 输出参数
参数类型说明
codeInt状态码
xNosTokenString上传凭证
bucketString存储上传文件的桶名
objectString存储上传文件的对象名
msgString错误信息
6.1.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
6.1.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d'{&originFileName&:&love.mp4&,&userFileName&:&for_love.mp4&,&typeId&:20,&presetId&:20,&description&:&for love&,&wartermarkId&:20}' https://vcloud.163.com/app/vod/upload/init
&Content-Type&: &application/ charset=utf-8&
&code& : 200,
&xNosToken& : &UPLOAD abe1b8e5ee:n5VKrOLVFkLM7JIBDaCyPjzVKswqfxBZak2U2fXh0xM=:eyJCdWNrZXQiOiJ2b2RrMzJ5d3hkZiIsIk9iamVjdCI6ImEzM2U1MmQ3LTUxZGMtNDZhNS1iMTFlLWFiNmMyMmJiOTk2ZC5KUEciLCJFeHBpcmVzIjoxNDY5NTg3NTc5LCJDYWxsYmFja1VybCI6Imh0dHA6Ly8xMDYuMi40NC4yNDgveGhyL3ZvZC9ub3MvY2FsbGJhY2siLCJDYWxsYmFja0JvZHkiOiJmaWxlTmFtZT10ZXN0LkpQRyZvYmplY3ROYW1lPWEzM2U1MmQ3LTUxZGMtNDZhNS1iMTFlLWFiNmMyMmJiOTk2ZC5KUEcmJChPYmplY3RTaXplKSZ1aWQ9MjQxMzMmdHlwZUlkPTAmcHJlc2V0SWQ9MCZ3YXRlcm1hcmtJZHM9bnVsbCZkZXNjcmlwdGlvbj1udWxsJnZpZGVvQ2FsbGJhY2s9bnVsbCYkKEFWaW5mby5WaWRlby5EdXJhdGlvbikmJChBVmluZm8uVmlkZW8uSGVpZ2h0KSYkKEFWaW5mby5WaWRlby5XaWR0aCkmMCYwJjAmbnVsbCZ1cGxvYWRTdGFydD0xNDY2OTk1NTc5NjU4In0=&,
&bucket& : &vodk32ywxdf&,
&object& : &d9-4dd9-820d-4c66a71952ad.mp4&
6.2 获取上传加速节点地址
6.2.1 接口描述
接口名：/lbs?version=1.0&bucketname={bucket}
用于获取上传加速节点地址。
6.2.2 输入参数
参数类型必须说明
versionString是API版本号，填写固定值1.0
bucketnameString是存储上传文件的桶名，可在视频上传初始化接口的返回参数bucket获取
6.2.3 输出参数
参数类型说明
lbsStringhttpDNS的IP访问地址，用于避免后续查询的DNS解析时间、以及域名劫持
uploadList上传节点列表（前面的优先级高）
6.2.4 错误响应
参数类型说明
CodeString错误代码
MessageString错误描述信息
6.2.5 示例
curl -X GET http://wanproxy.127.net/lbs?version=1.0&bucketname=vodk32ywxdf
{&lbs&:&http://223.252.196.39/lbs&,&upload&：[&http://223.252.216.48&,&http://223.252.216.49&]}
6.3 文件数据上传
上传一块数据，此接口通过指定offset实现断点续传功能。用户每次上传要以服务器端返回的offset为准续传余下数据。
需注意以下事项：
大文件需要自行分片上传，分片大小不超过4MB，请求相同接口，注意参数的填写。
如果需要断点续传，需保存 context 值，根据 context 值查询断点值，然后继续使用此接口。
包体数据为二进制数据。
6.3.1 接口描述
POST {UploadHost}/{bucket}/{object}
重要提示：{UploadHost}值为获取的上传加速节点地址，{bucket}值为存储对象的桶名，{object}值为生成的唯一对象名。
6.3.2 请求参数
参数类型必须说明
x-nos-tokenString是请求头参数，上传token
Content-Lengthlong否请求头参数，当前片的内容长度，单位：字节（Byte）。Content-Length合法值是[0~4M]，否则返回400 httpcode给客户端，拒绝本次请求
Content-TypeString否请求头参数，标准http头。表示请求内容的类型，比如：image/jpeg。 仅第一次上传生效，续传不生效
Content-MD5String否请求头参数，文件内容md5值
bucketString是存储对象的桶名
objectString是生成的唯一对象名
offsetlong是当前分片在整个对象中的起始偏移量，单位：字节（Byte）
completeString是是否为最后一块数据。合法值：true/false
versionString是http api版本号。这里是固定值1.0
contextString是上传上下文。本字段是只能被上传服务器解读使用的不透明字段，上传端不应修改其内容。注意：用户第一次上传应不带此参数或置为空字符串，之后上传剩余部分数据都需要带上这个参数。 context对应的桶名或者对象名不匹配返回400 code
6.3.3 响应参数
参数类型必须说明
requestIdString是uuid字符串，服务器端生成的唯一UUID
offsetlong是下一个上传片在上传块中的偏移。注意：偏移从0开始，比如：用户上传0-128字节后，服务器返回的offset为128，下一次上传offset值应置为128
contextString是上传上下文
callbackRetMsgString是上传回调信息
6.3.4 错误响应
参数类型说明
requestIdStringuuid字符串，服务器端生成的唯一UUID
errMsgString错误描述信息
6.3.5 响应状态码
HTTP状态码含义
200上传分片成功
400请求报文格式错误，报文构造不正确或者没有完整发送
403上传凭证无效。token过期服务器会返回此状态码，用户需要重新申请token
500服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
520回调失败
6.3.6 示例
curl -X POST -H &Content-Length: 4194304& -H &x-nos-token: UPLOAD abe1b8e5ee:n5VKrOLVFkLM7JIBDaCyPjzVKswqfxBZak2U2fXh0xM=:eyJCdWNrZXQiOiJ2b2RrMzJ5d3hkZiIsIk9iamVjdCI6ImEzM2U1MmQ3LTUxZGMtNDZhNS1iMTFlLWFiNmMyMmJiOTk2ZC5KUEciLCJFeHBpcmVzIjoxNDY5NTg3NTc5LCJDYWxsYmFja1VybCI6Imh0dHA6Ly8xMDYuMi40NC4yNDgveGhyL3ZvZC9ub3MvY2FsbGJhY2siLCJDYWxsYmFja0JvZHkiOiJmaWxlTmFtZT10ZXN0LkpQRyZvYmplY3ROYW1lPWEzM2U1MmQ3LTUxZGMtNDZhNS1iMTFlLWFiNmMyMmJiOTk2ZC5KUEcmJChPYmplY3RTaXplKSZ1aWQ9MjQxMzMmdHlwZUlkPTAmcHJlc2V0SWQ9MCZ3YXRlcm1hcmtJZHM9bnVsbCZkZXNjcmlwdGlvbj1udWxsJnZpZGVvQ2FsbGJhY2s9bnVsbCYkKEFWaW5mby5WaWRlby5EdXJhdGlvbikmJChBVmluZm8uVmlkZW8uSGVpZ2h0KSYkKEFWaW5mby5WaWRlby5XaWR0aCkmMCYwJjAmbnVsbCZ1cGxvYWRTdGFydD0xNDY2OTk1NTc5NjU4In0=& -d'[本次上传视频文件二进制内容数据]' &http://223.252.216.49/vodk32ywxdf/d9-4dd9-820d-4c66a71952ad.mp4?offset=0&complete=false&version=1.0&
&requestId&:&be82c2a0dffca189d831&,
&offset&:4194304,
&context&:&f3e-5a21-6ee4-39ff47af21c7&,
&callbackRetMsg&:&&
6.4 断点续传查询断点
根据上传上下文查询对应分片上传当前续传的offset，上下文要与bucketName/objectName匹配，否则返回400状态码。(bucketName和objectName要进行URL编码,字符编码格式使用utf-8)。
6.4.1 接口描述
GET {UploadHost}/{bucket}/{object}?uploadContext
重要提示：{UploadHost}值为获取的上传加速节点地址，{bucket}值为存储对象的桶名，{object}值为生成的唯一对象名。
6.4.2 请求参数
参数类型必须说明
x-nos-tokenString是上传token
bucketNameString是存储对象的桶名
objectNameString是生成的唯一对象名
contextString是上传上下文。本字段是只能被上传服务器解读使用的不透明字段，上传端不应修改其内容。对应context在服务端不存在则返回404。context对应的桶名或者对象名不匹配返回400 code。
versionString是http api版本号。这里是固定值1.0
6.4.3 响应参数
参数类型必须说明
requestIdString是uuid字符串，服务器端生成的唯一UUID，用于记录日志排查问题使用
offsetlong是下一个上传片在上传块中的偏移
6.4.4 错误响应
参数类型说明
requestIdStringuuid字符串，服务器端生成的唯一UUID
errMsgString错误描述信息
6.4.5 响应状态码
HTTP状态码含义
200上传分片成功
400请求报文格式错误，报文构造不正确或者没有完整发送
403上传凭证无效。token过期服务器会返回此错误码，用户需要重新申请token
500服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
404对应context上传不存在
6.4.6 示例
curl -X GET -H &x-nos-token: UPLOAD abe1b8e5ee:n5VKrOLVFkLM7JIBDaCyPjzVKswqfxBZak2U2fXh0xM=:eyJCdWNrZXQiOiJ2b2RrMzJ5d3hkZiIsIk9iamVjdCI6ImEzM2U1MmQ3LTUxZGMtNDZhNS1iMTFlLWFiNmMyMmJiOTk2ZC5KUEciLCJFeHBpcmVzIjoxNDY5NTg3NTc5LCJDYWxsYmFja1VybCI6Imh0dHA6Ly8xMDYuMi40NC4yNDgveGhyL3ZvZC9ub3MvY2FsbGJhY2siLCJDYWxsYmFja0JvZHkiOiJmaWxlTmFtZT10ZXN0LkpQRyZvYmplY3ROYW1lPWEzM2U1MmQ3LTUxZGMtNDZhNS1iMTFlLWFiNmMyMmJiOTk2ZC5KUEcmJChPYmplY3RTaXplKSZ1aWQ9MjQxMzMmdHlwZUlkPTAmcHJlc2V0SWQ9MCZ3YXRlcm1hcmtJZHM9bnVsbCZkZXNjcmlwdGlvbj1udWxsJnZpZGVvQ2FsbGJhY2s9bnVsbCYkKEFWaW5mby5WaWRlby5EdXJhdGlvbikmJChBVmluZm8uVmlkZW8uSGVpZ2h0KSYkKEFWaW5mby5WaWRlby5XaWR0aCkmMCYwJjAmbnVsbCZ1cGxvYWRTdGFydD0xNDY2OTk1NTc5NjU4In0=& &http://223.252.216.49/vodk32ywxdf/d9-4dd9-820d-4c66a71952ad.mp4?uploadContext&context=f3e-5a21-6ee4-39ff47af21c7&version=1.0&
&requestId&:&be82c2a0dffca189d832&,
&offset&:4194304
6.5 上传完成根据对象名查询视频或水印图片主Id
6.5.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/video/query
用于视频或水印上传完成后查询主Id。
6.5.2 输入参数
参数类型必须说明
objectNamesList是上传文件的对象名列表
6.5.3 输出参数
参数类型说明
codeInt状态码
listList对象名和视频Id对应的列表
list.vidInt视频主Id
list.imgIdInt视频水印图片Id
list.objectNameString存储上传文件的对象名
msgString错误信息
6.5.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
6.5.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d'{&objectNames&:[&33cf71b1-86ac--d70db07b9685.mp4&]}' https://vcloud.163.com/app/vod/video/query
&Content-Type&: &application/ charset=utf-8&
&code& : 200,
&objectName& : &33cf71b1-86ac--d70db07b9685.mp4&,
&vid& : 1008
7 视频截图
7.1 获取视频截图地址
7.1.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/snapshot/create
针对具体文件，获取其不同尺寸下的截图URL地址。支持截图的文件格式：mpegts|mov,mp4,m4a,3gp,3g2,mj2|rm|asf|flv|avi|matroska,webm|mpeg|mpeg|mpegtsraw|mpegvideo|mtv|mv|mvi|nuv|3gp|avs|avsvideo|adxl|dv|dvd|flic|flac|h261|h263|h264|hls|m4v|mjpeg|rawvideo|rpl|avcd|truehd|vc-1|vcd。如有不支持格式视频，请进行转码，接口会根据转码后的视频截取图片。
截取图片比例如果和视频尺寸比例不相符合，会自动填充黑边，保证图片显示正常。
7.1.2 输入参数
参数类型必须说明
vidInt是视频Id
sizeInt是截图尺寸，包含以下几种值：0表示原始视频比例，1表示640360，2表示400300，3表示320180，4表示200150，5表示1280720，6表示960720，7表示360640，8表示300400，9表示180320，10表示150200，11表示7201280，12表示720960，13表示180180，14表示360360，15表示720*720
offsetInt是截图偏移，包含以下几种值：0表示视频第一秒，1表示时间轴10%位置，2表示时间轴20%位置，3表示时间轴30%位置，4表示时间轴40%位置，5表示时间轴50%位置，6表示时间轴60%位置，7表示时间轴70%位置，8表示时间轴80%位置，9表示时间轴90%位置
7.1.3 输出参数
参数类型说明
codeInt状态码
urlString截图地址
widthString截图宽度
heightString截图高度
msgString错误信息
7.1.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
7.1.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:12,&size&:1,&offset&:0}' https://vcloud.163.com/app/vod/snapshot/create
&Content-Type&: &application/ charset=utf-8&
&url& : &http://vodk32ywxdf.nosdn.127.net/fsfs-gdgs-gdgd-gdgds_snapshot_0_640.jpg&,
&width& : &640&,
&height& : &320&
&code& : 200
7.2 设置视频封面
7.2.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/snapshot/set
为视频设置显示封面。
7.2.2 输入参数
参数类型必须说明
vidInt是视频Id
typeInt是封面设置方法：1表示使用截图URL，2表示使用本地上传图片
pathString是type值为1，则代表截图URL；type值为2，则代表本地图片路径
dataString否type值为2时，需填写，代表本地图片数据的base64编码字符串数据
重要提示：使用截图URL设置视频封面的URL必需是存储在网易云视频点播服务的URL，暂不支持第三方URL。
7.2.3 输出参数
参数类型说明
codeInt状态码
urlString截图地址
msgString错误信息
7.2.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
7.2.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vid&:12,&type&:1,&path&:&http://vodk32ywxdf.nosdn.127.net/fsfs-gdgs-gdgd-gdgds_snapshot_0_640.jpg&}' https://vcloud.163.com/app/vod/snapshot/set
&Content-Type&: &application/ charset=utf-8&
&url& : &http://vodk32ywxdf.nosdn.127.net/fsfs-gdgs-gdgd-gdgds_snapshot_0_640.jpg&
&code& : 200
8 视频转码
8.1 视频文件转码
8.1.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/transcode/resetmulti
用于视频转码，批量进行视频转码（只有处于正常或失败的视频才允许执行此操作）。
8.1.2 输入参数
参数类型必须说明
vidsList是多个视频Id组成的列表
presetIdInt是转码模板Id
watermarkIdInt否视频水印Id（不填写为不添加水印，且若填写，presetId值不能为默认模板）
userDefInfoString否用户自定义信息，回调会返回此信息
8.1.3 输出参数
参数类型说明
codeInt状态码
successCountInt转码成功的数量
failCountInt转码失败的数量
passCountInt转码忽略的数量，即已经存在该转码格式视频
msgString错误信息
8.1.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
8.1.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&vids&:[29,30],&presetId&:174,&watermarkId&:23}' https://vcloud.163.com/app/vod/transcode/resetmulti
&passCount&: 0,
&failCount&: 0,
&successCount&: 2
&code&: 200
9 回调通知
网易云视频点播的回调通知分为单个级别和用户级别，且处理优先级为：单个级别-&用户级别-&无回调。当用户设置了单个级别的回调地址，使用单个级别的回调地址；否则查询是否设置用户级别的回调地址，如果设置，使用用户级别的回调地址；否则不回调通知。单个级别的回调通知在上传初始化中指定，用户级别的回调通知可通过9.2和9.3设置。
回调通知会在请求头中增加sign字段，其值为拼接回调包体内容的字符串和签名字符串，然后对拼接后的字符串进行md5加密（32位小写）。签名字符串可通过接口9.2和9.3设置，默认为：vcloud。
目前网易云视频点播支持的回调通知包含上传成功和转码结果。
9.2 设置上传回调地址
9.2.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/upload/setcallback
用于视频上传，设置上传成功后的回调地址。
9.2.2 输入参数
参数类型必须说明
callbackUrlString是上传成功后回调客户端的URL地址
signKeyString否上传成功后回调客户端的签名字符串，要求是由字母和数字组成且不超过32位
9.2.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
9.2.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
9.2.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&callbackUrl&:&http://127.0.0.1/client/callback&}' https://vcloud.163.com/app/vod/upload/setcallback
&msg& : &&,
&code& : 200
注：上传完成后回调给客户地址为POST请求，包体为json格式数据，类似：{&name&:&snow.mp4&,&origAddr&:&http://vodk32ywxdf.vod.126.net/vodk32ywxdf/b3d259f4-a7bc-4119-ae24-60e0eb09216e.mp4&,&type&:&upload&,&vid&:1022,&user_defined&:&userId=123456&}。
9.3 设置转码回调地址
9.3.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/transcode/setcallback
用于视频转码，设置转码成功后的回调地址。
9.3.2 输入参数
参数类型必须说明
callbackUrlString否转码成功后回调客户端的URL地址
signKeyString否转码成功后回调客户端的签名字符串，要求是由字母和数字组成且不超过32位
9.3.3 输出参数
参数类型说明
codeInt状态码
msgString错误信息
9.3.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
9.3.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&callbackUrl&:&http://127.0.0.1/client/callback&}' https://vcloud.163.com/app/vod/transcode/setcallback
&msg& : &&,
&code& : 200
注：转码完成后回调给客户地址为POST请求，包体为json格式数据，类似：{&sdFlvAddr&:&http://vodk32ywxdf.vod.126.net/vodk32ywxdf/flv/rDM5V7HM_1021_sd.flv&,&name&:&snow.mp4&,&type&:&transcode&,&vid&:1021,&user_defined&:&userId=123456&}。
10 数据查询
10.1 流量统计查询
10.1.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/stats/flow
用于查询点播的流量使用统计数据。
10.1.2 输入参数
参数类型必须说明
startDateInt是需要查询的开始时间戳（单位：毫秒）
endDateInt是需要查询的结束时间戳（单位：毫秒）
currentPageInt是获取流量数据列表分页后的索引
pageSizeInt是获取流量数据列表一页的记录数（若为-1，表示不用分页）
10.1.3 输出参数
参数类型说明
codeInt状态码
totalFlowDouble查询时段的总流量（单位：MB）
startDateInt需要查询的开始时间戳（单位：毫秒）
endDateInt需要查询的结束时间戳（单位：毫秒）
currentPageInt当前取得页数
pageSizeInt一页的记录数目
pageNumInt总页数
totalRecordsInt获取流量数据的数目
listList流量数据列表
list.begintimeInt起始时间（单位：毫秒）
list.endtimeInt结束时间（单位：毫秒）
list.flowDouble流量值（单位：MB）
msgString错误信息
10.1.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
10.1.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&startDate&:0,&endDate&:0,&type&:5,&currentPage&:1,&pageSize&:10}' https://vcloud.163.com/app/vod/stats/flow
&startDate& : 0,
&endDate& : 0,
&totalFlow& : 1234.23,
&type& : 2,
&flowList& : [
&begintime& : 0,
&endtime& : ,
&flow& : 123.21
&currentPage& : 1,
&pageSize& : 10,
&pageNum& : 2,
&totalRecords& : 18
&code& : 200
10.2 带宽统计查询
10.2.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/stats/band
用于查询点播的带宽使用统计数据(统计粒度（1：每小时（2～7天）；2：每天（32～366天）；3：每十分钟（0～1天），4：每四小时（8～31天））)。
10.2.2 输入参数
参数类型必须说明
startDateInt是需要查询的开始时间戳（单位：毫秒）
endDateInt是需要查询的结束时间戳（单位：毫秒）
currentPageInt是获取带宽数据列表分页后的索引
pageSizeInt是获取带宽数据列表一页的记录数（若为-1，表示不用分页）
10.2.3 输出参数
参数类型说明
codeInt状态码
maxBandDouble查询时段的最大带宽值（单位：Mb/s）
startDateInt需要查询的开始时间戳（单位：毫秒）
endDateInt需要查询的结束时间戳（单位：毫秒）
currentPageInt当前取得页数
pageSizeInt一页的记录数目
pageNumInt总页数
totalRecordsInt获取带宽数据的数目
bandListList获取的带宽列表
bandList.begintimeInt起始时间（单位：毫秒）
bandList.endtimeInt结束时间（单位：毫秒）
bandList.bandDouble带宽值（单位：Mb/s）
msgString错误信息
10.2.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
10.2.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&startDate&:0,&endDate&:0,&type&:2,&currentPage&:1,&pageSize&:10}' https://vcloud.163.com/app/vod/stats/band
&startDate& : 0,
&endDate& : 0,
&maxBand& : 1234.23,
&type& : 2,
&bandList& : [
&begintime& : 0,
&endtime& : ,
&band& : 123.21
&currentPage& : 1,
&pageSize& : 10,
&pageNum& : 2,
&totalRecords& : 18
&code& : 200
10.3 存储统计查询
10.3.1 接口描述
域名：vcloud.163.com
接口名：/app/vod/stats/storage
用于查询点播的存储使用统计数据（查询粒度为天）。
10.3.2 输入参数
参数类型必须说明
startDateInt是需要查询的开始时间戳（单位：毫秒）
endDateInt是需要查询的结束时间戳（单位：毫秒）
currentPageInt是获取存储数据列表分页后的索引
pageSizeInt是获取存储数据列表一页的记录数（若为-1，表示不用分页）
10.3.3 输出参数
参数类型说明
codeInt状态码
totalStorageDouble查询时段的总存储量（单位：GB）
startDateInt需要查询的开始时间戳（单位：毫秒）
endDateInt需要查询的结束时间戳（单位：毫秒）
currentPageInt当前取得页数
pageSizeInt一页的记录数目
pageNumInt总页数
totalRecordsInt获取存储数据的数目
typeInt统计粒度（2：每天）
storageListList获取的存储列表
storageList.begintimeInt起始时间（单位：毫秒）
storageList.endtimeInt结束时间（单位：毫秒）
storageList.storageDouble存储量（单位：GB）
msgString错误信息
10.3.4 响应状态码
HTTP状态码含义
200操作成功
400请求报文格式错误，报文构造不正确或者没有完整发送
700服务器内部出现错误，请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710权限认证失败，请参考文档中的接口鉴权部分
720访问失败，余额不足。
721服务未开通，请前往开通页面申请服务开通
722服务开通审核中，请联系客服人员开通服务
723请求的次数超过了配额限制
10.3.5 示例
curl -X POST -H &Content-Type: application/charset=utf-8& -H &AppKey: cc4a65b5d98bc9d6af80b3& -H &Nonce: 1& -H &CurTime: & -H &CheckSum: 61bbfd88cba2abe7ae13& -d '{&startDate&:0,&endDate&:0,&type&:5,&currentPage&:1,&pageSize&:10}' https://vcloud.163.com/app/vod/stats/flow
&startDate& : 0,
&endDate& : 0,
&totalStorage& : 1234.23,
&type& : 2,
&storageList& : [
&begintime& : 0,
&endtime& : ,
&storage& : 123.21
&currentPage& : 1,
&pageSize& : 10,
&pageNum& : 2,
&totalRecords& : 18
&code& : 200
11 回源鉴权
回源鉴权是一种保护用户视频内容安全的功能。通过使用回源鉴权功能，用户可实时自行生成视频文件播放链接，该链接在用户指定时间内可用，从而有效保护视频内容。如果在使用回源鉴权功能之前，用户已经发布了播放地址。则在使用回源鉴权功能后，之前的播放地址不可用。用户需要通过动态生成链接以访问视频文件。
11.2 使用说明
1