获取当前会话用户出售中的商品列表

获取当前用户作为卖家的出售中的商品列表,并能根据传入的搜索条件对出售中的商品列表进行过滤 只能获得商品的部分信息 .

1.请求参数:

请求URL:

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

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
sys_id String 代表不同的应用,具体请咨询客服
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
sign String 接口签名 如何计算生成见示例代码
fields String 必填, 需返回的字段列表。可选值:Item商品结构体中的以下字段: approve_status,num_iid,title,nick,type,cid,pic_url,num,props,valid_thru,list_time,price,has_discount,has_invoice,has_warranty,has_showcase,modified,delist_time,postage_id,seller_cids,outer_id,sold_quantity ;字段之间用“,”分隔。不支持其他字段,如果需要获取其他字段数据,调用商品详情获取。
q String 选填 , 搜索字段。搜索商品的title。
cid number 选填, 商品类目ID。ItemCat中的cid字段。可以通过taobao.itemcats.get取到
seller_cids String 选填, 卖家店铺内自定义类目ID。多个之间用“,”分隔。可以根据taobao.sellercats.list.get获得.(注:目前最多支持32个ID号传入)
page_no number 选填, 页码。取值范围:大于零的整数。默认值为1,即默认返回第一页数据。用此接口获取数据时,当翻页获取的条数(page_no*page_size)超过10万,为了保护后台搜索引擎,接口将报错。所以请大家尽可能的细化自己的搜索条件,例如根据修改时间分段获取商品
has_discount boolean 选填, 是否参与会员折扣。可选值:true,false。默认不过滤该条件
has_showcase boolean 选填, 是否橱窗推荐。 可选值:true,false。默认不过滤该条件
order_by String 选填, 排序方式。格式为column:asc/desc ,column可选值:list_time(上架时间),delist_time(下架时间),num(商品数量),modified(最近修改时间),sold_quantity(商品销量),;默认上架时间降序(即最新上架排在前面)。如按照上架时间降序排序方式为list_time:desc
is_taobao boolean 选填, 商品是否在淘宝显示
is_ex boolean 选填, 商品是否在外部网店显示
page_size number 选填, 每页条数。取值范围:大于零的整数;最大值:100;默认值:40。用此接口获取数据时,当翻页获取的条数(page_no*page_size)超过2万,为了保护后台搜索引擎,接口将报错。所以请大家尽可能的细化自己的搜索条件,例如根据修改时间分段获取商品
start_modified String 选填, 格式:2000-01-01 00:00:00, 起始的修改时间
end_modified String 选填, 格式:2000-01-01 00:00:00 ,结束的修改时间
is_cspu boolean 选填, 是否挂接了达尔文标准产品体系
is_combine boolean 选填,组合商品
auction_type String 选填, 商品类型:a-拍卖,b-一口价

2. 请求示例代码(Java)

 @Test
    public void getItemOnSale() 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淘宝商品应用, 代表不同的应用,具体请咨询客服 
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());

        data.put("fields", "approve_status,num_iid,title,nick,type,cid,pic_url,num,props,valid_thru, " +
                "list_time,price,has_discount,has_invoice,has_warranty,has_showcase,modified,delist_time,postage_id,seller_cids,outer_id,sold_quantity");

        data.put("q", "");
        data.put("cid", "");
        data.put("seller_cids", "");
        data.put("page_no", "1");
        data.put("has_discount", "false");
        data.put("has_showcase", "false");
        data.put("order_by", "");
        data.put("is_taobao", "true");
        data.put("is_ex", "false");
        data.put("page_size", "10");
        data.put("start_modified", "");
        data.put("end_modified", "");
        data.put("is_cspu", "false");
        data.put("is_combine", "false");
        data.put("auction_type", "b"); // 商品类型:a-拍卖,b-一口价 
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoItemOnSaleUrl ,data);

    }

3. 返回结果如下:

 {
    "code": 0,
    "message": "ok",
    "data": {
        "items": {
            "item": [
                {
                    "approve_status": "onsale", // 状态为在售
                    "cid": 50019097,
                    "delist_time": "2020-12-26 23:56:16", // 下架时间(格式:yyyy-MM-dd HH:mm:ss)
                    "has_discount": false,
                    "has_invoice": false,
                    "has_showcase": false,
                    "has_warranty": false,
                    "list_time": "2020-12-19 23:56:16",  // 上架时间(格式:yyyy-MM-dd HH:mm:ss)
                    "modified": "2020-10-07 14:24:07",
                    "nick": "百鞋馆", 
                    "num": 5513,
                    "num_iid": 538919658474,  // 商品数字id
                    "outer_id": "soft002",  // 商家外部编码(可与商家外部系统对接)
                    "pic_url": "https://img.alicdn.com/bao/uploaded/i1/661153176/TB2.k.YX76z11Bjy0FoXXbvkpXa_!!661153176.png",
                    "postage_id": 1190535780,
                    "price": "2.00", // 商品价格,格式:5.00;单位:元;精确到:分
                    "props": "3748093:4480205;5392163:27432;8648185:29423;8648373:29423;25154154:29545", // 商品属性 格式:pid:vid;pid:vid
                    "seller_cids": ",410284344,", // 商品所属的店铺内卖家自定义类目列表
                    "sold_quantity": 23, // 商品销量 
                    "title": "软件开发优惠权222222222",  // 宝贝标题
                    "type": "fixed",
                    "valid_thru": 7  // 有效期,7或者14(默认是14天)
                } 
            ]
        },
        "request_id": "4hlfk0uunhyb",
        "total_results": 1  // 符合查询条件的商品总数
    }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含订单列表的数据。

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