创建媒资分类
功能介绍
创建媒资分类。
接口约束
最大支持三级分类,每个分类最多支持创建128个子分类。
URI
POST /v1.0/{project_id}/asset/category
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方法请参考获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token,使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Authorization |
否 |
String |
使用AK/SK方式认证时必选,携带的鉴权信息。 |
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选,请求的发生时间。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
媒资分类名称,最大64字节。 |
parent_id |
否 |
Integer |
父分类ID。 若不填,则默认生成一级分类。 根节点分类ID为0。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
媒资分类名称。 |
parent_id |
Integer |
父分类ID。 一级分类父ID为0。 |
id |
Integer |
媒资分类ID。 |
level |
Integer |
媒资分类层级。 取值如下:
|
projectId |
String |
项目ID。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误描述。 |
请求示例
创建媒资分类
POST https://{endpoint}/v1.0/{project_id}/asset/category Content-Type: application/json { "name": "电影" }
响应示例
状态码: 200
处理成功返回。
{ "id" : 334, "name" : "电影", "parent_id" : 0, "level" : 1, "projectId" : "58411d8df9064*****75d75b54e01358" }
状态码: 400
处理失败返回。
{ "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }
状态码
状态码 |
描述 |
---|---|
200 |
处理成功返回。 |
400 |
处理失败返回。 |
错误码
请参见错误码。