> For the complete documentation index, see [llms.txt](https://polyv.gitbook.io/document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://polyv.gitbook.io/document/docs/vod/api/video-management/manage/update_video_info.md).
# 修改视频信息
### 接口描述
```
1、通过视频id修改视频信息
2、接口URL中的{userid}为点播账号userid，具体参考菜单【使用须知】->【获取密钥】
3、接口支持https协议
```
### 接口URL
```
http://api.polyv.net/v2/video/{userid}/video-info
```
[在线API调用](https://git.polyv.net/help-center/document-center/-/blob/master/req.html?api=http:/api.polyv.net/v2/video/%7Buserid%7D/video-info/README.md)
### 请求方式
```
POST
```
### 接口约束
1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，[详细请查看](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/limit/README.md)
### 请求参数描述
| 参数名 | 必选 | 类型 | 说明 |
| ---------- | ----- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| userid | true | String | 保利威点播账户id，可以参考【[获取密钥](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/getSecretKey/README.md)】获取，获取路径：官网->登录->点播（API接口） |
| ptime | true | Long | 当前时间的毫秒级时间戳，3分钟内有效 |
| sign | true | String | 签名，为40位大写的SHA1值,`生成签名的secretkey密钥作为通信数据安全的关键信息，严禁保存在客户端直接使用，所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据`【详见[签名生成规则](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/buildSign/README.md)】 |
| vid | true | String | 视频id |
| describ | false | String | 视频描述 |
| format | false | String | 返回的数据格式，默认返回json格式
xml：返回xml格式
json：返回json格式
|
| publishUrl | false | String | 视频首发外链地址 |
| tag | false | String | 视频标签 |
| title | false | String | 视频标题 |
### 示例
```requestUrl
http://api.polyv.net/v2/video/1b448be323/video-info
```
表单参数：
```requestUrl
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为失败【详见[全局错误说明](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/errorInfo/README.md)】 |
| status | String | 响应状态文本信息 |
| message | String | 响应描述信息，当code为400或者500的时候，辅助描述错误原因 |
| data | Array | 响应成功时返回视频详细信息【详见[data字段说明](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/video_management/manage/update_video_info.md?id=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字段说明](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/video_management/manage/update_video_info.md?id=uploader字段说明)】 |
| cataname | String | 分类名称 |
#### uploader字段说明
| 参数名 | 类型 | 说明 |
| ----- | ------ | ------------------ |
| email | String | 上传者邮箱 |
| name | String | 上传者名称 |
| role | String | 上传者角色，如管理员，上传者，主账号 |
### Java请求示例
快速接入基础代码请下载相关依赖源码， [点击下载源代码](https://git.polyv.net/help-center/document-center/-/blob/master/third_res/util.zip) ,下载后加入到自己的源码工程中即可。测试用例中的**HttpUtil.java 和 VodSignUtil.java** 都包含在下载文件中。
> 强烈建议您使用[点播Java SDK](https://git.polyv.net/help-center/document-center/-/blob/master/vod/java/README.md)完成API的功能对接，点播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
```java
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 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
}
```
### 响应示例
系统全局错误说明详见[全局错误说明](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/errorInfo/README.md)
成功示例
```json
{
"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": "默认分类"
}
]
}
```
异常示例
```json
{
"code": 400,
"status": "error",
"message": "请先选择目标视频。",
"data": ""
}
```