全部产品
云市场

获取分类及子分类

更新时间:2019-02-15 13:46:59

描述

获取指定的分类信息及子分类(下一级分类)列表。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值:GetCategories
CateIdLong分类ID。
默认为根节点分类ID,即-1。
PageNoLong子分类列表页号。
默认值:1
PageSizeLong子分类列表页长。最大不超过100。
默认值:10

返回参数

名称类型描述
RequestId String 请求ID。
Category Category 指定分类的信息。
SubTotal Long 子分类总数。
SubCategoriesCategory[]子分类列表。

API示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=GetCategories&CateId=67788823&Format=JSON&<公共参数>

注意:示例中的“公共参数”参见 公共参数说明文档

返回示例

JSON格式

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "Category": {
  4. "CateId": 67788823,
  5. "CateName": "exampleCategory-A",
  6. "ParentId": -1,
  7. "Level": 0
  8. },
  9. "SubTotal": 2,
  10. "SubCategories": {
  11. "Category": [
  12. {
  13. "CateId": 87788825,
  14. "CateName": "exampleCategory-A-sub1",
  15. "ParentId": 67788823,
  16. "Level": 1
  17. },
  18. {
  19. "CateId": 87788826,
  20. "CateName": "exampleCategory-A-sub2",
  21. "ParentId": 67788823,
  22. "Level": 1
  23. }
  24. ]
  25. }
  26. }

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息,参见 错误码表

错误代码错误信息HTTP 状态码说明
InvalidCateId.NotFoundThe CateId not exist.404分类ID不存在。

SDK示例

建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: