修改视频信息

接口描述

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

接口URL

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

在线API调用

请求方式

POST

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看

请求参数描述

参数名

必选

类型

说明

userid

true

String

保利威点播账户id，可以参考【获取密钥】获取，获取路径：官网->登录->点播（API接口）

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

响应参数描述

参数名

类型

说明

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

视频标题

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字段说明

参数名

类型

说明

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": ""
}

Previous修改视频预览时长 Next视频禁播与解禁

Last updated 3 months ago

Was this helpful?