创建分类_媒资分类_媒资管理_服务端API

描述

创建视频分类。最多支持三级分类，每个分类最多支持100个子分类。

请求参数

名称	类型	是否必需	描述
Action	String	是	系统规定参数。取值：AddCategory
CateName	String	是	分类名称。不能超过64个字节。 UTF8编码。
ParentId	Long	否	父分类ID。若不填，则默认生成一级分类，根节点分类ID为-1。

返回参数

名称	类型	描述
RequestId	String	请求ID。
Category	Category	视频分类信息。

API示例

请求示例

http://vod.cn-shanghai.aliyuncs.com/?Action=AddCategory&CateName=exampleCategory&Format=JSON&<公共参数>

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

返回示例

JSON格式

    {
      "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
      "Category": {
          "CateId": 67788823,
          "CateName": "exampleCategory",
          "ParentId": -1,
          "Level": 0
      }
    }

错误码

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

错误代码	错误信息	HTTP 状态码	说明
LevelExceededMax	The level of categories exceeded maximum.	400	分类层级超过最大限制。
SubTotalExceededMax	The total of sub categories exceeded maximum.	400	子分类个数超过最大限制。
InvalidCateId.NotFound	The CateId not exist.	404	父分类ID不存在。

SDK示例

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