修改视频信息
接口描述
1、通过视频id修改视频信息
2、接口URL中的{userid}为点播账号userid,具体参考菜单【使用须知】->【获取密钥】
3、接口支持https协议
接口URL
http://api.polyv.net/v2/video/{userid}/video-info
请求方式
POST
接口约束
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看
请求参数描述
ptime
true
Long
当前时间的毫秒级时间戳,3分钟内有效
sign
true
String
签名,为40位大写的SHA1值,生成签名的secretkey密钥作为通信数据安全的关键信息,严禁保存在客户端直接使用,所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据
【详见签名生成规则】
vid
true
String
视频id
describ
false
String
视频描述
format
false
String
返回的数据格式,默认返回json格式 xml:返回xml格式 json:返回json格式
publishUrl
false
String
视频首发外链地址
tag
false
String
视频标签
title
false
String
视频标题
示例
http://api.polyv.net/v2/video/1b448be323/video-info
表单参数:
vid=1b448be323871ffe3d5a84a3638e82c2_1&describ=%E4%BF%9D%E5%88%A9%E5%A8%81%E6%98%AF%E5%85%A8%E7%90%83%E9%A2%86%E5%85%88%E7%9A%84%E4%BC%81%E4%B8%9A%E7%9B%B4%E6%92%AD%E6%9C%8D%E5%8A%A1%E5%95%86%EF%BC%8C%E9%9A%B6%E5%B1%9E%E4%BA%8E%E5%B9%BF%E5%B7%9E%E6%98%93%E6%96%B9%E4%BF%A1%E6%81%AF%E7%A7%91%E6%8A%80%E8%82%A1%E4%BB%BD%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8%EF%BC%8C%E8%87%B4%E5%8A%9B%E4%BA%8E%E9%80%9A%E8%BF%87%E5%8F%AF%E9%9B%86%E6%88%90%E3%80%81%E5%8F%AF%E5%AE%9A%E5%88%B6%E7%9A%84%E8%A7%86%E9%A2%91%E7%9B%B4%E6%92%AD%E6%8A%80%E6%9C%AF%EF%BC%8C%E4%B8%BA%E4%BC%81%E4%B8%9A%E6%90%AD%E5%BB%BA%E8%87%AA%E4%B8%BB%E7%A7%81%E5%9F%9F%E7%9B%B4%E6%92%AD%E7%B3%BB%E7%BB%9F%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9B%E7%9B%B4%E6%92%AD%E5%85%A8%E6%B5%81%E7%A8%8B%E8%BF%90%E8%90%A5%E4%B8%8E%E7%8E%B0%E5%9C%BA%E6%89%A7%E8%A1%8C%E6%9C%8D%E5%8A%A1%E3%80%82&sign=5AA9AF13716BCFF428B7E4C2F59930BDEF1DD901&tag=%E5%AE%A3%E4%BC%A0%E8%A7%86%E9%A2%91&title=%E4%BF%9D%E5%88%A9%E5%A8%81%E5%AE%A3%E4%BC%A0%E8%A7%86%E9%A2%91&userId=1b448be323&ptime=1670903195195&publishUrl=http%3A%2F%2Fwww.polyv.net
响应参数描述
data字段说明
images_b
String[]
视频截图大图地址
images
String[]
视频截图小图地址
imageUrls
String[]
视频截图访问链接
tag
String
视频标签
mp4
String
流畅码率mp4格式视频地址
title
String
视频标题
df
Integer
视频码率数
times
String
播放次数
vid
String
视频id
mp4_1
String
流畅码率mp4格式视频地址
mp4_2
String
高清码率mp4格式视频地址
mp4_3
String
超清码率mp4格式视频地址
cataid
String
分类id, 如1为默认分类
swf_link
String
返回flash链接
status
String
视频状态 60/61:已发布 10:等待编码 20:正在编码 50:等待审核 51:审核不通过 -1:已删除
seed
Integer
加密视频为1,非加密为0
flv1
String
流畅码率flv格式视频地址
flv2
String
高清码率flv格式视频地址
flv3
String
超清码率flv格式视频地址
sourcefile
String
源文件
playerwidth
String
视频宽度
default_video
String
用户默认播放视频
duration
String
视频时长,格式:时:分:秒,如:00:00:48
first_image
String
视频首图
original_definition
String
最佳分辨率
context
String
视频描述
playerheight
String
视频高度
ptime
String
上传时间
source_filesize
Long
源文件大小,单位:byte
filesize
Long[]
编码后各个清晰度视频的文件大小,单位:byte
md5checksum
String
md5校验值
hls
String[]
编码后各个清晰度视频的m3u8地址
keepsource
String
是否为源文件,否:0,是:1
cataname
String
分类名称
uploader字段说明
String
上传者邮箱
name
String
上传者名称
role
String
上传者角色,如管理员,上传者,主账号
Java请求示例
快速接入基础代码请下载相关依赖源码, 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 VodSignUtil.java 都包含在下载文件中。
强烈建议您使用点播Java SDK完成API的功能对接,点播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
private static final Logger log = LoggerFactory.getLogger(VodVideoManagementTest.class);
/**
* 修改视频信息
*/
@Test
public void testUpdateVideoInfo() throws Exception, NoSuchAlgorithmException {
//公共参数,填写自己的实际参数
String secretKey = super.secretKey;
String userId = super.userId;
String ptime = String.valueOf(System.currentTimeMillis());
//业务参数
String url = "http://api.polyv.net/v2/video/" + userId + "/video-info";
String vid = "1b448be323871ffe3d5a84a3638e82c2_1";
String title = "保利威宣传视频";
String describ = "保利威是全球领先的企业直播服务商,隶属于广州易方信息科技股份有限公司,致力于通过可集成、可定制的视频直播技术,为企业搭建自主私域直播系统,并提供直播全流程运营与现场执行服务。";
String tag = "宣传视频";
String publishUrl = "http://www.polyv.net";
Map<String, String> requestMap = new HashMap<>();
requestMap.put("userId", userId);
requestMap.put("ptime", ptime);
requestMap.put("vid", vid);
requestMap.put("describ", describ);
requestMap.put("tag", tag);
requestMap.put("title", title);
requestMap.put("publishUrl", publishUrl);
requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey));
String response = HttpUtil.postFormBody(url, requestMap);
log.debug("测试修改视频信息,{}", response);
//do somethings
}
响应示例
系统全局错误说明详见全局错误说明
成功示例
{
"code": 200,
"status": "success",
"message": "success",
"data": [
{
"images_b": [
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_0_b.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1_b.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2_b.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3_b.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_4_b.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_5_b.jpg"
],
"images": [
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_0.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_4.jpg",
"1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_5.jpg"
],
"imageUrls": [
"http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_0.jpg",
"http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.jpg",
"http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.jpg",
"http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.jpg",
"http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_4.jpg",
"http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_5.jpg"
],
"tag": "宣传视频",
"mp4": "http://mpv.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.mp4",
"title": "保利威宣传视频",
"df": 3,
"times": "0",
"vid": "1b448be323871ffe3d5a84a3638e82c2_1",
"mp4_1": "http://mpv.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.mp4",
"mp4_2": "http://mpv.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.mp4",
"mp4_3": "http://mpv.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.mp4",
"cataid": "1",
"swf_link": "http://player.polyv.net/videos/1b448be323871ffe3d5a84a3638e82c2_1.swf",
"status": "61",
"seed": 1,
"flv1": "http://plvod01.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.mp4",
"flv2": "http://plvod01.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.mp4",
"flv3": "http://plvod01.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.mp4",
"sourcefile": "",
"playerwidth": "600",
"default_video": "http://plvod01.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.mp4",
"duration": "00:01:49",
"first_image": "http://img.videocc.net/uimage/1/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_0_b.jpg",
"original_definition": "1920x1080",
"context": "保利威是全球领先的企业直播服务商,隶属于广州易方信息科技股份有限公司,致力于通过可集成、可定制的视频直播技术,为企业搭建自主私域直播系统,并提供直播全流程运营与现场执行服务。",
"playerheight": "337",
"ptime": "2022-12-12 17:47:19",
"source_filesize": 18839865,
"filesize": [
7774918,
14508330,
18866914
],
"md5checksum": "4b88804c015da508b5008f95846befc1",
"hls": [
"http://hls.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_1.m3u8",
"http://hls.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_2.m3u8",
"http://hls.videocc.net/1b448be323/2/1b448be323871ffe3d5a84a3638e82c2_3.m3u8"
],
"uploader": {
"email": "sdk-demo@polyv.net",
"name": "sdk功能测试账号",
"role": "主账号"
},
"keepsource": "",
"cataname": "默认分类"
}
]
}
异常示例
{
"code": 400,
"status": "error",
"message": "请先选择目标视频。",
"data": ""
}
Last updated
Was this helpful?