接口URL
https://api.polyv.net/v3/video/update-info
接口说明
(接口调用有频率限制,详细请查看)
1、接口用于修改视频信息
2、接口支持https
请求方式
POST
请求参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
appId | 是 | string | 子账号appId |
timestamp | 是 | long | 当前13位当前时间戳,3分钟有效 |
sign | 是 | string | 签名值,32位大写MD5值 |
vid | 是 | string | 视频ID |
title | 否 | string | 视频标题 |
describ | 否 | string | 视频描述 |
tag | 否 | string | 视频标签信息 |
publishUrl | 否 | string | 外链地址 |
响应成功JSON示例:
// 修改成功
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 200,
"status": "success",
"error": null,
"data": null
}
响应失败JSON示例:
// 时间戳错误
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 400,
"status": "error",
"error": {
"code": 100,
"desc": "invalid timestamp"
},
"data": null
}
// appId不正确
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 400,
"status": "error",
"error": {
"code": 101,
"desc": "application not exist"
},
"data": null
}
// 子账号不存在
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 400,
"status": "error",
"error": {
"code": 102,
"desc": "user children not exist"
},
"data": null
}
// 子账号过期
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 403,
"status": "error",
"error": {
"code": 103,
"desc": "user children expired"
},
"data": null
}
// 签名错误
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 403,
"status": "error",
"error": {
"code": 104,
"desc": "invalid signature"
},
"data": null
}
// 账号权限不足
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 403,
"status": "error",
"error": {
"code": 105,
"desc": "permission limited"
},
"data": null
}
// 视频vid错误
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 400,
"status": "error",
"error": {
"code": 2000,
"desc": "invalid vid"
},
"data": null
}
// 视频正在上传中
{
"requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
"code": 400,
"status": "error",
"error": {
"code": 3100,
"desc": "上传中不允许修改"
},
"data": null
}
字段说明
字段 | 说明 |
---|---|
requestId | 本次请求的ID |
code | 响应http状态码 |
status | 状态 |
error.code | 错误码 |
error.desc | 错误描述 |
data | 返回数据 |
java请求示例
public void testUpdateInfo() {
String url = "https://api.polyv.net/v3/video/update-info";
// appId和加密串
String appId = "xxxxxxx";
String appSecret = "xxxxxxxxxxxxxxxxxx";
Map<String, String> params = new HashMap<>();
params.put("vid", "xxx");
params.put("title", "标题");
params.put("describ", "描述");
params.put("tag", "视频标签");
params.put("publishUrl", "外链地址");
// 调用Polyv的工具类方法设置sign
PolyvTool.setLiveSign(params, appId, appSecret);
String content = HttpClientUtil.getInstance()
.sendHttpPost(url, params);
System.out.println(content);
}
签名规则及工具文件代码
https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/