获取单个商品详细信息

获取单个商品的全部信息

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/item/detail

参数名	类型	说明	示例
appid	String	合作伙伴AppId	uwkahf@jfs92
timestamp	String	当前时间戳
tb_seller_nick	String	淘宝卖家店铺登录账号，非店铺名称	kingdo
sign	String	接口签名	如何计算生成见示例代码
fields	String	必填， 需返回的字段列表。可选值： 需要返回的商品字段列表。可选值：Item商品结构体中所有字段均可返回，多个字段用“,”分隔。
num_iid	number	必填 ， 商品数字ID
sysid	String	可空， 代表不同的应用，具体请咨询客服

二、请求示例代码

Java

@Test
    public void getItemDetail() 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());
        // 需要获取的商品字段，更多字段见第4节返回字段说明。
        String defaultFields  =   "num_iid,title,nick,price,approve_status,sku,num,list_time,delist_time,stuff_status,price,post_fee,express_fee,ems_fee,auction_point,skus,item_img,prop_img," +
                "barcode,created,features" ;
        data.put("fields", defaultFields);
        data.put("num_iid", "544876335798");
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoItemDetailUrl ,data);

    }

三、返回结果

返回的商品字段取决于请求时的fields字段，下面是部分商品字段。

{
    "code": 0,
    "message": "ok",
    "data": {
        "item": {
            "approve_status": "onsale",
            "auction_point": 0,
            "created": "2017-02-09 11:34:20",
            "delist_time": "2020-12-26 23:56:13",
            "ems_fee": "0.00",
            "express_fee": "0.00",
            "features": "tags:104514,426754,1797506",
            "item_imgs": {},
            "list_time": "2020-12-19 23:56:13",
            "newprepay": "default",
            "nick": "百鞋馆",
            "num": 4285,
            "num_iid": 544876335798,
            "post_fee": "0.00",
            "price": "1.50",
            "skus": {
                "sku": [
                    {
                        "created": "2018-09-11 18:28:43",
                        "modified": "2019-09-20 14:38:55",
                        "outer_id": "red35",
                        "price": "0.50",
                        "properties": "-3:-7;-4:-8",
                        "properties_name": "-3:-7:尺码:35;-4:-8:颜色:red",
                        "quantity": 0,
                        "sku_id": 3977338583164
                    },
                    {
                        "created": "2018-09-11 18:28:43",
                        "modified": "2019-09-20 14:14:50",
                        "outer_id": "white35",
                        "price": "1.50",
                        "properties": "-3:-7;-4:-9",
                        "properties_name": "-3:-7:尺码:35;-4:-9:颜色:white",
                        "quantity": 15,
                        "sku_id": 3977338583166
                    },
                    {
                        "created": "2018-09-11 18:28:43",
                        "modified": "2019-07-05 17:12:49",
                        "outer_id": "red36",
                        "price": "5.00",
                        "properties": "-3:-10;-4:-8",
                        "properties_name": "-3:-10:尺码:36;-4:-8:颜色:red",
                        "quantity": 40,
                        "sku_id": 3977338583163
                    },
                    {
                        "created": "2018-09-11 18:28:43",
                        "modified": "2019-07-05 17:12:49",
                        "outer_id": "white36",
                        "price": "5.00",
                        "properties": "-3:-10;-4:-9",
                        "properties_name": "-3:-10:尺码:36;-4:-9:颜色:white",
                        "quantity": 4230,
                        "sku_id": 3977338583165
                    }
                ]
            },
            "stuff_status": "new",
            "title": "联华超市提取货券xx"
        },
        "request_id": "11gh3rhk0sted"
    }
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

四、返回字段说明

返回的商品字段取决于请求时的fields字段，下面是部分商品字段，详细字段可见淘宝文档