全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
新增图片分类信息
接口地址： http://api.vv-tool.com/tool/erps/tbcategoryadd
接口介绍： 同一卖家最多添加 500 个图片分类，图片分类名称长度最大为 20 个字符
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 请求次数收费，联系运营
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| shop_id | String | true | 店铺 id | |
| picture_category_name | String | true | abcdefg | 图片分类名称，最大长度 20 字符，中文字符算 2 个字符，不能为空 |
| parent_id | Number | false | 0 | 图片分类的父分类，一级分类的 parent_id 为 0,二级分类的则为其父分类的 picture_category_id |
| vvtype | int | false | 增强版 2，增强版的需要传参 2,必须传 2 |
请求示例
{
shop_id:12345
picture_category_name:12
vvtype:2
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| picture_category | PictureCategory | 123 | 图片分类信息 |
| picture_category_id | Number | 1234 | 图片分类 ID |
| picture_category_name | String | 名称 | 图片分类名 |
| type | String | sys-fixture | 图片分类型别，sys-fixture 代表店铺装修分类(系统分类)，sys-auction 代表宝贝图片分类(系统分类)，user-define 代表用户自定义分类 |
| created | Date | 2000-01-01 00:00:00 | 图片类目的创建时间 |
| modified | Date | 2000-01-01 00:00:00 | 图片分类的修改时间 |
| position | Number | 1 | 图片分类排序 |
| parent_id | Number | 0 | 一级分类的 parent_id 为 0 二级分类的则为其父分类的 picture_category_id |
| withholding_money | int | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"withholding_money":4,
"picture_category_add_response":{
"picture_category":{
"picture_category_id":1234,
"picture_category_name":"名称",
"type":"sys-fixture",
"created":"2000-01-01 00:00:00",
"modified":"2000-01-01 00:00:00",
"position":1,
"parent_id":0
}
}
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |