图片空间-获取图片分类信息
获取图片分类信息
获取图片分类信息
一、请求参数
请求URL:
POST https://kf.fw199.com/gateway/taobao/picture/category/get
基本参数
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
| sysid | String | 可空, 代表不同的应用,具体请咨询客服 |
业务参数
| 参数名 | 类型 | 必须 | 示例 | 说明 |
|---|---|---|---|---|
| picture_category_id | Number | false | 100 | 图片分类ID |
| picture_category_name | String | false | 分类 | 图片分类名,不支持模糊查询 |
| type | String | false | 1 | 1 |
| parent_id | Number | false | 0 | 取二级分类时设置为对应父分类id 取一级分类时父分类id设为0 取全部分类的时候不设或设为-1 |
| modified_time | Date | false | 2011-01-01 11:11:11 | 图片分类的修改时间点,格式:yyyy-MM-dd HH:mm:ss。查询此修改时间点之后到目前的图片分类。 |
二、请求示例代码
Java
@Test public void TaoBaoPictureCategoryGet() throws Exception {
String tb_seller_nick = Config.TBSellerNick ; //业务参数 Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); data.put("tb_seller_nick", tb_seller_nick); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); data.put("parent_id", "0"); // 签名 data.put("sign", Utils.Sign(data,Config.AppSecret)); // 调用服务API doHttpRequest(Config.TaoBaoPictureCategoryGet ,data);
}三、返回结果
{ "code": 0, "message": "ok", "data": [ { "picture_category_id": 13176115377194798, "picture_category_name": "店铺装修", "position": 0, "type": "fixed", "created": "2011-10-27 15:14:38", "modified": "2024-04-19 11:58:33", "parent_id": 0 }, { "picture_category_id": 13176115377194799, "picture_category_name": "宝贝图片", "position": 0, "type": "auction", "created": "2011-10-27 15:14:38", "modified": "2024-04-19 11:59:38", "parent_id": 0 }, { "picture_category_id": 1317618347909433447, "picture_category_name": "abc2", "position": 0, "type": "user-define", "created": "2025-01-09 19:16:39", "modified": "2025-01-09 19:16:39", "parent_id": 0 }, { "picture_category_id": 1317618347001286735, "picture_category_name": "abc3", "position": 0, "type": "user-define", "created": "2025-01-09 19:27:36", "modified": "2025-01-09 19:27:36", "parent_id": 0 } ], "trace_id": ""}说明: code为0表示成功, 如果失败,msg会包含失败原因。 返回的字段说明
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| picture_category_id | Number | 1234 | 图片分类ID |
| picture_category_name | String | 名称 | 图片分类名 |
| position | Number | 1 | 图片分类排序 |
| type | String | sys-fixture | 图片分类型别,sys-fixture代表店铺装修分类(系统分类),sys-auction代表宝贝图片分类(系统分类),user-define代表用户自定义分类 |
| total | Number | 100 | 分类下的图片数 |
| created | Date | 2000-01-01 00:00:00 | 图片类目的创建时间 |
| modified | Date | 2000-01-01 00:00:00 | 图片分类的修改时间 |
| parent_id | Number | 0 | 一级分类的parent_id为0 二级分类的则为其父分类的picture_category_id |