批量获取商品详细信息
批量获取商品详细信息
1.请求参数:
请求URL:
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
| fields | String | 必填, 需返回的字段列表。可选值: 需要返回的商品字段列表。可选值:Item商品结构体中所有字段均可返回,多个字段用“,”分隔。 | |
| numiids | String | 必填 , 商品数字ID,多个商品用英文逗号”,”隔开,最多传入100个商品Id | |
| sysid | String | 可空, 代表不同的应用,具体请咨询客服 |
2. 请求示例代码(Java)
@Test
public void itemSellerList() throws Exception {
String tb_seller_nick = Config.TBSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("sys_id", "102"); // 102淘宝商品应用, 代表不同的应用,具体请咨询客服
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tb_seller_nick", Config.TBSellerNick);
data.put("numiids", "641383788284,650219976849");
data.put("fields", "num_iid,title,nick,approve_status,num,sku,detail_url,type,cid,seller_cids,props,desc,pic_url,num,price,item_img,prop_img,videos,wap_detail_url,wap_desc,item_rectangle_img,cuntao_item_specific," +
"desc_modules,wireless_desc,mpic_video");
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoItemSellerListUrl ,data);
}
3. 返回结果如下:
返回的商品字段取决于请求时的fields字段,下面是部分商品字段,详细字段可见 淘宝文档
{"code":0,"message":"ok","data":[{"items":[{"nick":"s22298","pic_url":"https://img.alicdn.com/bao/uploaded/i2/1887935399/O1CN01xA0O5J1pknUacJgQW_!!4611686018427386791-53-xy_item.heic","price":"7.80","title":"王者万象棋"}],"request_id":"16kzgfk5j728b"}],"trace_id":"cfbd688e-a4e4-4aed-a7ef-326df39c42cd"}
说明: code为0表示成功,非0为失败,message会包含失败原因。 如果传入某个商品Id无效,则返回的集合中不会包含此商品。可通过集合中的num_iid来判断。
文档更新时间: 2026-05-11 20:47 作者:admin