跳转到内容
返回官网

根据商品ID列表获取SKU信息

配置说明

是否需要商家授权:需要 应用ID:100, 102,103 权限名称:淘宝根据商品ID列表获取SKU信息

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/item/skus/get

参数名类型说明示例
appidString合作伙伴AppIduwkahf@jfs92
timestampString当前时间戳
tb_seller_nickString淘宝卖家店铺登录账号,非店铺名称kingdo
signString接口签名如何计算生成见示例代码
num_iidsString必填 , sku所属商品数字id, num_iids个数不能超过40个, 多个用英文逗号隔开
sysidint可选 , 应用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_idNumber123sku的id
iidStringasdf12323adfaasku所属商品id(注意:iid近期即将废弃,请用num_iid参数)
num_iidNumber12345sku所属商品数字id
propertiesString1243:1215;5626:5125sku的销售属性组合字符串(颜色,大小,等等,可通过类目API获取某类目下的销售属性),格式是p1:v1;p2:v2
properties_nameString20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1sku所对应的销售属性的中文名字串,格式如:pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2……
quantityNumber3属于这个sku的商品的数量,
priceString200.07属于这个sku的商品的价格 取值范围:0-100000000;精确到2位小数;单位:元。如:200.07,表示:200元7分。
outer_idString12345商家设置的外部id。天猫和集市的卖家,需要登录才能获取到自己的商家编码,不能获取到他人的商家编码。
createdString2009-11-04 15:24:43sku创建日期 时间格式:yyyy-MM-dd HH:mm:ss
modifiedString2009-11-04 15:24:43sku最后修改日期 时间格式:yyyy-MM-dd HH:mm:ss
statusStringnormalsku状态。 normal:正常 ;delete:删除
sku_spec_idNumber123表示SKu上的产品规格信息
barcodeString6903244981002商品级别的条形码