接口功能介绍
通过本接口可在点播模式下为一个视频条目修改视频分类。请注意,每个视频条目仅允许创建一组不超过三级的视频分类。未创建视频分类的视频会自动归属于【未分类】的分类条目。创建、修改、删除分类仅影响视频分类的归属,不会影响视频条目的主体数据(封面、截图、视频等)。
接口约束
本接口的单用户QPS限制为20次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
URI
PUT /video/category
入参直接放在 body
中,content-type
为 application/json
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
id | 是 | Integer | 待修改视频分类id。 | 10000060012 | -- |
name | 是 | String | 修改后分类名称。 | 最新电影 | -- |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
code | 是 | Integer | 接口业务响应码:0-修改成功;非0-修改失败。 | 0 | |
message | 是 | String | 修改失败时为具体失败信息;成功时为""。 | "" |
请求示例
{
"id":10000060012,
"name":"武侠"
}
响应示例
{
"code":"0",
"message":""
}
状态码
Http 状态码 | 状态码信息 | 状态码描述 |
---|---|---|
0 | 表示业务成功 | 表示业务成功 |
400 | 请求参数有误 | 请求参数有误 |
403 | 用户鉴权失败,用户无操作权限 | 用户鉴权失败,用户无操作权限 |
404 | 请求的资源不存在,输入错误的URL | 请求的资源不存在,输入错误的URL |
500 | 业务执行异常 | 业务执行异常 |
错误码
OpenAPI错误码请参考 错误码说明。