接口功能介绍
用户可在点播模式下通过本接口修改媒体库的视频条目。
接口约束
本接口的单用户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错误码请参考 错误码说明。
