批量获取商品详细信息

批量获取商品详细信息

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/taobao/item/seller/list

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
sign String 接口签名 如何计算生成见示例代码
fields String 必填, 需返回的字段列表。可选值: 需要返回的商品字段列表。可选值:Item商品结构体中所有字段均可返回,多个字段用“,”分隔。
numiids String 必填 , 商品数字ID,多个商品用英文逗号”,”隔开,最多传入100个商品Id
sys_id 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": [{
        "approve_status": "onsale",
        "nick": "颜烨旗舰店",
        "num": 9998,
        "num_iid": 641383788284,
        "title": "碎花连衣裙女春夏2021年新款中长款假两件拼接配大衣内搭打底裙子"
    }, {
        "approve_status": "instock",
        "nick": "颜烨旗舰店",
        "num": 5943,
        "num_iid": 650219976849,
        "title": "POLO领连衣裙女2021夏季新款出游季优雅气质百搭田园小花A字裙子"
    }  ],
    "trace_id": ""
}

说明: code为0表示成功,非0为失败,message会包含失败原因。 如果传入某个商品Id无效,则返回的集合中不会包含此商品。可通过集合中的num_iid来判断。

文档更新时间: 2023-10-12 16:48   作者:admin