商品列表接口

商品列表查询

1.请求参数:

请求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

2. 请求示例代码(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);

    }

3. 返回结果

返回结果如下

{
    "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会包含失败原因。

4 返回参数说明

参数接口 参数类型 例子 说明
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 商品预扣库存
文档更新时间: 2023-03-14 17:04   作者:admin