调用AddCategory创建媒资分类。

使用说明

音视频/图片分类(Type为default)最多支持三级分类,每级分类最多支持创建100个子分类;短视频素材分类(Type为material)最多支持两级分类,每级分类最多支持创建100个子分类。

QPS限制

本接口的单用户QPS限制为30次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AddCategory

系统规定参数。取值:AddCategory

CateName String 搞笑

分类名称。

  • 最多支持64个字节。
  • UTF-8编码。
ParentId Long 100012****

父分类ID。可登录点播控制台,选择配置管理 > 媒资管理配置 > 分类管理 > 音视频/图片分类短视频素材分类查看分类ID。

说明
  • 若填写了ID,则在该分类下创建子分类。若不填,则创建一级分类。
  • 因短视频素材分类的一级分类全部为内置的,不支持修改、新增、删除,仅支持在一级分类下创建子分类,所以当Type为material时,此字段必填。
Type String default

分类类型。取值:

  • default(默认值):音视频/图片分类。
  • material:短视频素材分类。

返回数据

名称 类型 示例值 描述
RequestId String 25818875-5F78-4AF6-D7393642CA58****

请求ID。

Category Object

媒资分类信息。

Type String default

分类类型。取值:

  • default(默认值):音视频/图片分类。
  • material:短视频素材分类。
ParentId Long 100012

父分类ID。

CateName String 搞笑

分类名称。

CateId Long 10020

创建的分类ID。

Level Long 1

分类层级。一级分类层级为0,二级分类层级为1,三级分类层级为2

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=AddCategory
&CateName=搞笑
&Type=default
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AddCategoryResponse>
    <RequestId>25818875-5F78-4AF6-D7393642CA58****</RequestId>
    <Category>
        <Type>default</Type>
        <ParentId>100012****</ParentId>
        <CateName>搞笑</CateName>
        <CateId>10020****</CateId>
        <Level>1</Level>
    </Category>
</AddCategoryResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4AF6-D7393642CA58****",
  "Category" : {
    "Type" : "default",
    "ParentId" : "100012****",
    "CateName" : "搞笑",
    "CateId" : "10020****",
    "Level" : 1
  }
}

错误码

访问错误中心查看更多错误码。

接口错误码

下表列举了本接口特有的错误码。

错误代码

错误信息

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各语言调用的示例代码,请参见: