调用本接口按ID或类型来筛选查询指定的分类信息，及其子分类（即下一级分类）的列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vod:GetCategories |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CateId |
integer |
否 |
分类 ID，传入此参数，则可查询指定 ID 的分类。仅支持传入单个分类 ID。可通过以下方式获取：
|
49339**** |
| PageNo |
integer |
否 |
子分类列表页号。默认值为 1。 |
1 |
| PageSize |
integer |
否 |
子分类列表页大小。默认值为 10，最大值为 100。 |
10 |
| SortBy |
string |
否 |
查询结果排序。取值：
|
CreationTime:Desc |
| Type |
string |
否 |
分类类型，传入此参数，则可筛选查询指定类型的分类。取值：
|
default |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| SubTotal |
integer |
子分类总数。 |
2 |
| RequestId |
string |
请求 ID。 |
25818875-5F78-4AF6-D7393642CA58**** |
| Category |
object |
分类的详细信息。 |
|
| Type |
string |
分类类型。取值：
|
default |
| ParentId |
integer |
父分类 ID。 |
100012**** |
| CateName |
string |
分类名称。 |
Movie |
| CateId |
integer |
分类 ID。 |
100 |
| Level |
integer |
分类层级。取值：
|
0 |
| SubCategories |
object |
||
| Category |
array<object> |
子分类的详细信息。 |
|
|
object |
|||
| Type |
string |
子分类的类型。取值：
|
default |
| CateName |
string |
分类名称。 |
电影 |
| ParentId |
integer |
父分类 ID。 |
10020**** |
| CateId |
integer |
分类 ID。 |
100 |
| SubTotal |
integer |
子分类总数。 |
1 |
| Level |
integer |
分类层级。取值：
|
1 |
示例
正常返回示例
JSON格式
{
"SubTotal": 2,
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"Category": {
"Type": "default",
"ParentId": 0,
"CateName": "Movie",
"CateId": 100,
"Level": 0
},
"SubCategories": {
"Category": [
{
"Type": "default",
"CateName": "电影",
"ParentId": 0,
"CateId": 100,
"SubTotal": 1,
"Level": 1
}
]
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。