批量新增素材分类接口
企业可通过此接口批量新增素材分类信息。
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/media/category/batch_add_category_info
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
[
{
"user_id": "fake_data1",
"parent_id": 0,
"category_name": "fake_data1",
"material_type": 66,
"package_config_id": 11
},
{
"user_id": "fake_data2",
"parent_id": 0,
"category_name": "fake_data2",
"material_type": 66,
"package_config_id": 11
}
]
参数 | 类型 | 最大长度 | 必填 | 说明 |
---|---|---|---|---|
param | array | 数组最大长度为20 | 是 | body请求参数为数组 |
user_id | string | 是 | 员工ID | |
parent_id | long | 是 | 父分类ID 一级分类的话,该字段传入0 二级分类的话,传入对应的一级分类ID即可 |
|
category_name | string | 10 | 是 | 分类名称 当该分类为一级分类的时候,该分类名称为全局唯一 当该分类为二级分类的时候,该分类名称在当前一级分类下唯一 |
material_type | int | 是 | 素材分类类型 | |
package_config_id | long | 否 | 当material_type=14,组合素材类型ID为必填 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": [
{
"parent_id": 68,
"category_id": 59,
"category_name": "fake_data1",
"material_type": 25
},
{
"parent_id": 69,
"category_id": 59,
"category_name": "fake_data2",
"material_type": 25
}
]
}
返回说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 出错返回码,为0表示成功,非0表示调用失败 |
msg | string | 返回码描述 |
data | array | 素材分类信息数组 |
category_id | long | 分类id,当该字段为空的时候,说明该条数据操作异常,具体异常原因查看err_msg字段 |
parent_id | long | 父级分类id |
category_name | string | 分类名 |
material_type | int | 素材类型 |
err_msg | string | 异常信息,该字段主要针对部分业务数据处理异常时给出的异常信息提示,当正常处理的时候,该字段为空.当处理失败的时候,该字段不为空 |
material_type参数信息
code码 | 中文说明 |
---|---|
1 | 海报 |
2 | 文本 |
3 | 图片 |
4 | 文章 |
5 | 语音 |
6 | 视频 |
7 | 文件 |
8 | 小程序 |
9 | 网页 |
10 | 优惠券 |
11 | 商品 |
12 | 活动 |
13 | 产品 |
14 | 素材包 |
PS:现在一个批量请求,传入十条数据,假如第5条数据有问题,不会终止业务.直到处理完第10条数据,业务才会结束.