商品列表接口
商品列表查询
1.请求参数:
请求URL:
参数名 | 类型 | 必须 | 说明 |
---|---|---|---|
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