商品列表接口

商品列表查询

支持应用：OMS

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/pdd/goods/list/get

参数名	类型	必须	说明
appid	String	必填	合作伙伴AppId
timestamp	String	必填	当前时间戳
tb_seller_nick	String	必填	拼多多账号, 非店铺名称
sign	String	必填	如何计算生成见示例代码
is_onsale	INTEGER	非必填	上下架状态，0-下架，1-上架,outer_id,is_onsale,goods_name三选一，优先级is_onsale>outer_id>goods_name
goods_name	STRING	非必填	商品名称模糊查询,outer_id,is_onsale,goods_name三选一，优先级is_onsale>outer_id>goods_name
page_size	INTEGER	非必填	返回数量，默认 100，最大100。
page	INTEGER	非必填	返回页码默认 1，页码从 1 开始PS：当前采用分页返回，数量和页数会一起传，如果不传，则采用默认值
outer_goods_id	STRING	非必填	商家外部商品编码，支持多个，用逗号隔开，最多10个
cost_template_id	LONG	非必填	模版id

二、请求示例代码

Java

@Test
    public void PddGoodsListGet() throws Exception {

        String seller_nick = Config.PddSellerNick; // 拼多多卖家账号
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("seller_nick", seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("is_onsale", "1");
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.PddGoodsListGetUrl, data);

    }

三、返回结果

返回结果如下

{
    "code": 0,
    "message": "ok",
    "data": {
        "goods_list": [{
            "goods_id": 160210883299,
            "goods_name": "A4白纸一张十圆不支持退货,不要乱拍!",
            "goods_quantity": 111192,
            "goods_reserve_quantity": 0,
            "image_url": "",
            "is_more_sku": 1,
            "is_onsale": 1,
            "sku_list": [{
                "is_sku_onsale": 1,
                "outer_goods_id": "g100",
                "outer_id": "s100cm",
                "reserve_quantity": 0,
                "sku_id": 648106686605,
                "sku_quantity": 111111,
                "spec": "100cm"
            }, {
                "is_sku_onsale": 1,
                "outer_goods_id": "g100",
                "outer_id": "s50cm",
                "reserve_quantity": 0,
                "sku_id": 648106686604,
                "sku_quantity": 81,
                "spec": "50cm"
            }],
            "thumb_url": "http://t00img.yangkeduo.com/goods/images/2020-08-01/e153908d8b9fd170578848f81d504645.jpeg"
        }],
        "request_id": "16338735757038323",
        "total_count": 1
    },
    "trace_id": ""
}

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

四、返回参数说明

参数接口	参数类型	说明
total_count	INTEGER	返回商品总数
goods_list	OBJECT[]	商品列表对象
thumb_url	STRING	商品缩略图
goods_id	LONG	商品编码
goods_name	STRING	商品名称
image_url	STRING	商品图片
is_more_sku	INTEGER	是否多sku，0-单sku，1-多sku
goods_quantity	LONG	商品总数量
is_onsale	INTEGER	是否在架上，0-下架中，1-架上
sku_list	OBJECT[]	sku列表对象
spec	STRING	规格名称
sku_id	LONG	sku编码
sku_quantity	LONG	sku库存
outer_id	STRING	商家外部编码（sku），同其他接口中的outer_id 、out_id、out_sku_sn、outer_sku_sn、out_sku_id、outer_sku_id 都为商家编码（sku维度）。
outer_goods_id	STRING	商家外部编码（商品），同其他接口中的outer_goods_id 、out_goods_id、out_goods_sn、outer_goods_sn 都为商家编码（goods维度）。
is_sku_onsale	INTEGER	sku是否在架上，0-下架中，1-架上
reserve_quantity	LONG	sku预扣库存
goods_reserve_quantity	LONG	商品预扣库存