根据商品ID列表获取SKU信息
配置说明
是否需要商家授权:需要 应用ID:100, 102,103 权限名称:淘宝根据商品ID列表获取SKU信息
一、请求参数
请求URL:
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
| num_iids | String | 必填 , sku所属商品数字id, num_iids个数不能超过40个, 多个用英文逗号隔开 | |
| sysid | int | 可选 , 应用ID, 默认100 |
二、请求示例代码
Java
@Test public void TaobaoItemSkusGet() throws Exception { Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); data.put("tb_seller_nick", Config.TBSellerNick); data.put("num_iids", "900197514510"); data.put("sign", Utils.Sign(data,Config.AppSecret)); doHttpRequest(Config.TaobaoItemSkusGetUrl ,data);
}三、返回结果
返回结果如下:
{ "code": 0, "message": "ok", "data": [ { "sku_id": 5757483161278, "iid": "900197514510", "num_iid": 900197514510, "properties": "1627207:28326;20509:84509", "properties_name": "1627207:28326:颜色分类:红色;20509:84509:尺码:X", "quantity": 10, "price": "400.00", "outer_id": "2222", "created": "2025-03-19 14:14:08", "modified": "2025-03-20 11:54:48", "status": "normal", "sku_spec_id": 0, "barcode": "6901234567892" }, { "sku_id": 5757483161279, "iid": "900197514510", "num_iid": 900197514510, "properties": "1627207:28326;20509:28317", "properties_name": "1627207:28326:颜色分类:红色;20509:28317:尺码:XL", "quantity": 10, "price": "400.00", "outer_id": "223", "created": "2025-03-19 14:14:08", "modified": "2025-03-20 11:54:48", "status": "normal", "sku_spec_id": 0 }, { "sku_id": 5757483161280, "iid": "900197514510", "num_iid": 900197514510, "properties": "1627207:28326;20509:28318", "properties_name": "1627207:28326:颜色分类:红色;20509:28318:尺码:XXL", "quantity": 1, "price": "111.00", "outer_id": "", "created": "2025-03-19 14:14:08", "modified": "2025-03-20 11:54:48", "status": "normal", "sku_spec_id": 0 }, { "sku_id": 5757483161281, "iid": "900197514510", "num_iid": 900197514510, "properties": "1627207:4266701;20509:84509", "properties_name": "1627207:4266701:颜色分类:米白色;20509:84509:尺码:X", "quantity": 10, "price": "400.00", "outer_id": "", "created": "2025-03-19 14:14:08", "modified": "2025-03-20 11:54:48", "status": "normal", "sku_spec_id": 0 }, { "sku_id": 5757483161282, "iid": "900197514510", "num_iid": 900197514510, "properties": "1627207:4266701;20509:28317", "properties_name": "1627207:4266701:颜色分类:米白色;20509:28317:尺码:XL", "quantity": 10, "price": "400.00", "outer_id": "", "created": "2025-03-19 14:14:08", "modified": "2025-03-20 11:54:48", "status": "normal", "sku_spec_id": 0 }, { "sku_id": 5757483161283, "iid": "900197514510", "num_iid": 900197514510, "properties": "1627207:4266701;20509:28318", "properties_name": "1627207:4266701:颜色分类:米白色;20509:28318:尺码:XXL", "quantity": 1, "price": "111.00", "outer_id": "", "created": "2025-03-19 14:14:08", "modified": "2025-03-20 11:54:48", "status": "normal", "sku_spec_id": 0 } ], "trace_id": ""}说明: code为0表示成功,非0为失败,message会包含失败原因。
四、返回字段说明
| 字段 | 类型 | 示例 | 说明 |
|---|---|---|---|
| sku_id | Number | 123 | sku的id |
| iid | String | asdf12323adfaa | sku所属商品id(注意:iid近期即将废弃,请用num_iid参数) |
| num_iid | Number | 12345 | sku所属商品数字id |
| properties | String | 1243:1215;5626:5125 | sku的销售属性组合字符串(颜色,大小,等等,可通过类目API获取某类目下的销售属性),格式是p1:v1;p2:v2 |
| properties_name | String | 20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1 | sku所对应的销售属性的中文名字串,格式如:pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2…… |
| quantity | Number | 3 | 属于这个sku的商品的数量, |
| price | String | 200.07 | 属于这个sku的商品的价格 取值范围:0-100000000;精确到2位小数;单位:元。如:200.07,表示:200元7分。 |
| outer_id | String | 12345 | 商家设置的外部id。天猫和集市的卖家,需要登录才能获取到自己的商家编码,不能获取到他人的商家编码。 |
| created | String | 2009-11-04 15:24:43 | sku创建日期 时间格式:yyyy-MM-dd HH:mm:ss |
| modified | String | 2009-11-04 15:24:43 | sku最后修改日期 时间格式:yyyy-MM-dd HH:mm:ss |
| status | String | normal | sku状态。 normal:正常 ;delete:删除 |
| sku_spec_id | Number | 123 | 表示SKu上的产品规格信息 |
| barcode | String | 6903244981002 | 商品级别的条形码 |