调用AddCategory创建视频分类。最大支持三级分类,每个分类最多支持创建100个子分类。

调试

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

请求参数

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

系统规定参数,取值:AddCategory

CateName String 搞笑

分类名称。

  • 不能超过64个字节。
  • UTF8编码。
ParentId Long 1000126088

父分类ID。若不填,则默认生成一级分类,根节点分类ID为-1

Type String Video

素材片段类型。取值:

  • Video(默认):视频
  • Image:图片

返回数据

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

请求ID。

Category Struct

视频分类信息。

CateId Long 100200304

视频分类ID。

CateName String 电影

分类名称,最大64字节,UTF8编码。

Level Long 0

分类层级,一级分类层级为0

ParentId Long -1

父分类ID,一级分类父ID为-1

Type String Video

素材片段类型。取值:

  • Video(默认):视频
  • Image:图片
说明 下述请求示例中的“公共请求参数”详情,参见公共参数说明文档

示例

请求示例

http(s)://[Endpoint]/?Action=AddCategory
&CateName=搞笑
&<公共请求参数>

正常返回示例

XML 格式

<AddCategoryResponse>
	  <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
	  <Category>
		    <CateId>67788823</CateId>
		    <CateName>exampleCategory</CateName>
		    <ParentId>-1</ParentId>
		    <Level>0</Level>
	  </Category>
</AddCategoryResponse>

JSON 格式

{
    "RequestId": "25818875-5F78-4A*****F6-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各语言调用的示例代码,请参考如下: