接口功能介绍
用户可在点播模式下通过本接口修改媒体库的视频条目。
接口约束
本接口的单用户QPS限制为20次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
URI
POST /video/update
请求体body参数
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
videoId |
是 |
String |
视频ID |
34c71dba-f280-4f5e-a05f-f4daed837fef |
|
name |
否 |
String |
视频的名称,如果不传入则不修改。 |
我的视频 |
|
remark |
否 |
String |
视频简介,如不传入则不修改,注意:传入空字符串也会修改为空。 |
"备注" |
|
tags |
否 |
Array of Strings |
视频标签,不传入则不修改,注意:传入空列表或者空字符串将会删除所有标签。 |
["爱情片", "历史片"] |
|
categoryId |
否 |
Integer |
视频分类ID。不传默认将该视频分类为【未分类】。 |
10000600098 |
|
响应参数
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
code |
是 |
Integer |
本次请求的结果码。 |
0 |
|
message |
是 |
String |
错误文本信息,执行成功时,为空字符串。 |
"" |
|
请求示例
{
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
"name": "我的视频",
"remark": "备注",
"tags": ["爱情片", "历史片"],
"categoryId":10000600098
}
响应示例
{
"code": 0,
"message": ""
}
状态码
Http 状态码 |
状态码信息 |
状态码描述 |
0 |
表示业务成功 |
表示业务成功 |
400 |
请求参数有误 |
请求参数有误 |
403 |
用户鉴权失败,用户无操作权限 |
用户鉴权失败,用户无操作权限 |
404 |
请求的资源不存在,输入错误的URL |
请求的资源不存在,输入错误的URL |
500 |
业务执行异常 |
业务执行异常 |
错误码
OpenAPI错误码请参考 错误码说明。