修改视频信息

更新时间：2025-01-14 14:42:44

接口描述

1、通过视频id修改视频信息
2、接口URL中的{userid}为点播账号userid，具体参考菜单【使用须知】->【获取密钥】
3、接口支持https协议

接口URL

http://api.polyv.net/v2/video/{userid}/video-info

在线API调用

请求方式

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&ptime=1670903195195&publishUrl=http%3A%2F%2Fwww.polyv.net

响应参数描述

参数名	类型	说明
code	Integer	响应状态码，200为成功返回，非200为失败【详见全局错误说明】
status	String	响应状态文本信息
message	String	响应描述信息，当code为400或者500的时候，辅助描述错误原因
data	Array	响应成功时返回视频详细信息【详见data字段说明】

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
uploader	Object	上传者信息【详见uploader字段说明】
cataname	String	分类名称

uploader字段说明

参数名	类型	说明
email	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": ""
}

点播服务器 API