获取分类及子分类_媒资分类_媒资管理_服务端API

描述

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

请求参数

名称	类型	是否必需	描述
Action	String	是	系统规定参数。取值：GetCategories
CateId	Long	否	分类ID。默认为根节点分类ID，即-1。
PageNo	Long	否	子分类列表页号。默认值：1
PageSize	Long	否	子分类列表页长。最大不超过100。默认值：10

返回参数

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

API示例

请求示例

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

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

返回示例

JSON格式

    {
      "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
      "Category": {
              "CateId": 67788823,
              "CateName": "exampleCategory-A",
              "ParentId": -1,
              "Level": 0
        },
      "SubTotal": 2,
      "SubCategories": {
        "Category": [
            {
              "CateId": 87788825,
              "CateName": "exampleCategory-A-sub1",
              "ParentId": 67788823,
              "Level": 1
            },
            {
              "CateId": 87788826,
              "CateName": "exampleCategory-A-sub2",
              "ParentId": 67788823,
              "Level": 1
            }
          ]
      }
    }

错误码

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

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

SDK示例

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