查询指定分类信息
功能介绍
查询指定分类信息,及其子分类(即下一级分类)的列表。
URI
GET /v1.0/{project_id}/asset/category
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方法请参考获取项目ID |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
id |
是 |
Integer |
视频分类ID。 若设置为0或者null,则查询项目Id下所有一级分类。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token,使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Authorization |
否 |
String |
使用AK/SK方式认证时必选,携带的鉴权信息。 |
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选,请求的发生时间。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
[数组元素] |
Array of QueryCategoryRsp objects |
分类返回值 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
分类ID。 |
name |
String |
分类名称。 |
children |
Array of QueryCategoryRsp objects |
子分类列表。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
查询指定分类信息
GET https://{endpoint}/v1.0/{project_id}/asset/category?id={id}
响应示例
状态码: 200
处理成功返回。
[ { "id" : "334", "name" : "电影", "children" : [ { "id" : "335", "name" : "电视", "children" : [ ] } ] } ]
状态码: 400
处理失败返回。
{ "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
状态码
状态码 |
描述 |
---|---|
200 |
处理成功返回。 |
400 |
处理失败返回。 |
错误码
请参见错误码。