商品明细
获取商品明细
1.请求参数:
请求URL:
参数名 | 类型 | 必须 | 说明 |
---|---|---|---|
appid | String | 必填 | 合作伙伴AppId |
timestamp | String | 必填 | 当前时间戳 |
tb_seller_nick | String | 必填 | 拼多多账号, 非店铺名称 |
sign | String | 必填 | 如何计算生成见示例代码 |
goods_id | LONG | 必填 | 32342143 |
2. 请求示例代码(Java)
@Test
public void PddGoodsDetailGet() 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("goods_id", "160210883299");
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.PddGoodsDetailGetUrl, data);
}
3. 返回结果
返回结果如下
{
"code": 0,
"message": "ok",
"data": {
"bad_fruit_claim": 0,
"buy_limit": 999999,
"carousel_gallery_list": ["https://t16img.yangkeduo.com/garner-api/583314e6541c02a1bdf468c1aa66f0f6.jpeg"],
"cat_id": 18056,
"cost_template_id": 197590968702499,
"country_id": 0,
"customer_num": 2,
"customs": "",
"delivery_one_day": 0,
"delivery_type": null,
"detail_gallery_list": ["https://t16img.yangkeduo.com/garner-api/c983f38fa4e71e1330b8f32c8aff5b71.jpeg"],
"end_production_date": null,
"fabric_content_id": null,
"fabric_id": null,
"goods_desc": "杯架A测试商品请不要拍",
"goods_id": 160210883299,
"goods_name": "A4白纸一张十圆不支持退货,不要乱拍!",
"goods_pattern": 3,
"goods_property_list": [{
"punit": "",
"ref_pid": 310,
"template_pid": 137041,
"vid": 67,
"vvalue": "太力"
}, {
"punit": "",
"ref_pid": 317,
"template_pid": 137039,
"vid": 12854,
"vvalue": "塑料"
}],
"goods_trade_attr": null,
"goods_travel_attr": null,
"goods_type": 1,
"hd_thumb_url": "http://t00img.yangkeduo.com/goods/images/2020-08-01/7c64ec4a8ef337bc373b96162ace562f.jpeg",
"image_url": "",
"invoice_status": 0,
"is_customs": 0,
"is_folt": 1,
"is_group_pre_sale": null,
"is_pre_sale": 0,
"is_refundable": 1,
"is_sku_pre_sale": 0,
"lack_of_weight_claim": 0,
"mai_jia_zi_ti": null,
"market_price": 4000,
"order_limit": 999999,
"origin_country_id": 0,
"out_source_goods_id": null,
"out_source_type": null,
"outer_goods_id": "g100",
"oversea_goods": null,
"oversea_type": 0,
"paper_length": null,
"paper_net_weight": null,
"paper_plies_num": null,
"paper_width": null,
"pre_sale_time": 0,
"production_license": null,
"production_standard_number": null,
"quan_guo_lian_bao": 0,
"request_id": "16338768845354782",
"second_hand": 0,
"shang_men_an_zhuang": null,
"shelf_life": null,
"shipment_limit_second": 172800,
"size_spec_id": null,
"sku_list": [{
"is_onsale": 1,
"length": null,
"limit_quantity": 999999,
"multi_price": 1000,
"out_sku_sn": "s50cm",
"out_source_sku_id": null,
"oversea_sku": {
"measurement_code": null,
"measurement_unit": null,
"specifications": null,
"taxation": null
},
"price": 1500,
"quantity": 81,
"reserve_quantity": 0,
"sku_id": 648106686604,
"sku_pre_sale_time": null,
"sku_property_list": null,
"spec": [{
"parent_id": 1216,
"parent_name": "尺寸",
"spec_id": 72930,
"spec_name": "50cm"
}],
"thumb_url": "https://t16img.yangkeduo.com/garner-api/70ec7360c13688309252f88a9ce49965.jpeg",
"weight": 0
}, {
"is_onsale": 1,
"length": null,
"limit_quantity": 999999,
"multi_price": 1900,
"out_sku_sn": "s100cm",
"out_source_sku_id": null,
"oversea_sku": {
"measurement_code": null,
"measurement_unit": null,
"specifications": null,
"taxation": null
},
"price": 3300,
"quantity": 111111,
"reserve_quantity": 0,
"sku_id": 648106686605,
"sku_pre_sale_time": null,
"sku_property_list": null,
"spec": [{
"parent_id": 1216,
"parent_name": "尺寸",
"spec_id": 42,
"spec_name": "100cm"
}],
"thumb_url": "https://t16img.yangkeduo.com/garner-api/385531de9957fb1f3de0ce48956ee432.jpeg",
"weight": 0
}],
"sku_type": null,
"song_huo_an_zhuang": null,
"song_huo_ru_hu": null,
"start_production_date": null,
"status": 1,
"thumb_url": "http://t00img.yangkeduo.com/goods/images/2020-08-01/e153908d8b9fd170578848f81d504645.jpeg",
"tiny_name": "",
"video_gallery": [],
"warehouse": "",
"warm_tips": "",
"zhi_huan_bu_xiu": 0
},
"trace_id": ""
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
4 返回参数说明
参数接口 | 参数类型 | 例子 | 说明 |
---|---|---|---|
bad_fruit_claim | INTEGER | 坏果包赔 | |
buy_limit | LONG | 限购次数 | |
carousel_gallery_list | STRING[] | 商品轮播图列表 | |
cat_id | LONG | 叶子类目ID | |
cost_template_id | LONG | 运费模版id | |
country_id | INTEGER | 地区/国家id | |
customer_num | LONG | 团购人数 | |
customs | STRING | 海关名称 | |
delivery_one_day | INTEGER | 是否当日发货,0 否,1 是 | |
detail_gallery_list | STRING[] | 商品详情图 | |
goods_desc | STRING | 商品描述 | |
goods_id | LONG | 商品id | |
goods_name | STRING | 商品名称 | |
goods_property_list | OBJECT[] | 商品属性列表 | |
punit | STRING | 属性单位 | |
ref_pid | LONG | 引用属性id | |
template_pid | LONG | 模板属性Id | |
vid | LONG | 基础属性值Id | |
vvalue | STRING | 基础属性值 | |
goods_trade_attr | OBJECT | 日历商品交易相关信息 | |
advances_days | INTEGER | 提前预定天数,默认为0表示当天可预定 | |
booking_notes | OBJECT | 预订须知 | |
url | STRING | 预定须知图片地址 | |
life_span | INTEGER | 卡券有效期,日历日期后多少天可用。默认值为0表示仅限日历日当天使用 | |
goods_travel_attr | OBJECT | 日历商品出行信息 | |
need_tourist | BOOLEAN | 出行人是否必填(默认是) | |
type | INTEGER | 日历商品类型1:旅行类,2:住宿类,3:票务类 | |
goods_type | INTEGER | 商品类型:1-国内普通商品,2-进口,3-国外海淘,4-直邮 ,5-流量,6-话费,7,优惠券;8-QQ充值,9-加油卡 暂时支持1-普通商品的上架 | |
image_url | STRING | 商品主图 | |
invoice_status | INTEGER | 是否支持正品发票;0-不支持、1-支持 | |
is_customs | INTEGER | 是否需要上报海关 0:否 1:是 | |
is_folt | INTEGER | 是否支持假一赔十,0-不支持,1-支持 | |
is_pre_sale | INTEGER | 是否预售,1-预售商品,0-非预售商品 | |
is_refundable | INTEGER | 是否7天无理由退换货,1-支持,0-不支持 | |
lack_of_weight_claim | INTEGER | 缺重包退 | |
mai_jia_zi_ti | STRING | 买家自提模版id | |
market_price | LONG | 参考价格,单位为分 | |
order_limit | LONG | 单次限量 | |
outer_goods_id | STRING | 商家编码(商品维度),同其他接口中的outer_goods_id 、out_goods_id、out_goods_sn、outer_goods_sn 都为商家编码(goods维度)。 | |
out_source_goods_id | STRING | 第三方商品Id | |
out_source_type | INTEGER | 第三方商品来源 | |
oversea_goods | OBJECT | oversea_goods | |
bonded_warehouse_key | STRING | 保税仓唯一标识 | |
consumption_tax_rate | INTEGER | 消费税率 | |
customs_broker | STRING | 清关服务商 | |
hs_code | STRING | 海关编号 | |
value_added_tax_rate | INTEGER | 增值税率 | |
oversea_type | INTEGER | oversea_type | |
pre_sale_time | LONG | 预售时间 | |
quan_guo_lian_bao | INTEGER | 0:不支持全国联保;1:支持全国联保 | |
second_hand | INTEGER | 是否二手 1:是 0:否 | |
shang_men_an_zhuang | STRING | 上门安装模版id | |
shipment_limit_second | LONG | 承诺发货时间( 秒) | |
size_spec_id | LONG | 尺码表id | |
skuType | INTEGER | 库存方式(0:普通型,1:日历型) | |
sku_list | OBJECT[] | sku列表 | |
is_onsale | INTEGER | 上下架状态 1:上架 0 :下架 | |
length | LONG | sku送装参数:长度 | |
limit_quantity | LONG | sku购买限制 | |
multi_price | LONG | 商品团购价格 单位分 | |
out_sku_sn | STRING | 商家编码(sku维度),同其他接口中的outer_id 、out_id、out_sku_sn、outer_sku_sn、out_sku_id、outer_sku_id 都为商家编码(sku维度)。 | |
out_source_sku_id | STRING | 第三方sku Id | |
oversea_sku | OBJECT | oversea_sku | |
measurement_code | STRING | 计量单位编码,从接口pdd.gooods.sku.measurement.list获取desc | |
specifications | STRING | 规格 | |
taxation | INTEGER | 税费 | |
price | LONG | 商品单买价格 单位分 | |
quantity | LONG | 库存 | |
reserve_quantity | LONG | 预扣库存 | |
sku_id | LONG | sku编码 | |
spec | OBJECT[] | 商品规格列表 | |
parent_id | LONG | 自定义规格所属的规格ID | |
parent_name | STRING | 商品规格ID对应的规格名称 | |
spec_id | LONG | 自定义规格ID | |
spec_name | STRING | 自定义规格名称 | |
thumb_url | STRING | sku预览图 | |
weight | LONG | 重量,单位为g | |
sku_property_list | OBJECT[] | sku属性 | |
punit | STRING | 属性单位 | |
ref_pid | LONG | 属性id | |
value | STRING | 属性值 | |
vid | LONG | 属性值id | |
sku_pre_sale_time | INTEGER | sku预售时间,单位秒 | |
song_huo_an_zhuang | STRING | 送货入户并安装模版id | |
song_huo_ru_hu | STRING | 送货入户模版id | |
status | INTEGER | 商品状态 1:上架,2:下架,3:售罄 4:已删除 | |
tiny_name | STRING | 短标题,示例:新包装,保证产品的口感和新鲜度。单颗独立小包装,双重营养,1斤家庭分享装,更实惠新疆一级骏枣夹核桃仁。 | |
video_gallery | OBJECT[] | 商品视频 | |
file_id | LONG | 商品视频id | |
video_url | STRING | 商品视频url | |
warehouse | STRING | 保税仓 | |
warm_tips | STRING | 水果类目温馨提示 | |
zhi_huan_bu_xiu | INTEGER | 只换不修的天数,目前只支持0和365 | |
delivery_type | INTEGER | 发货方式。0:无物流发货;1:有物流发货。 | |
is_group_pre_sale | INTEGER | 是否成团预售。0:不是;1:是。 | |
is_sku_pre_sale | INTEGER | 是否sku预售,0:否,1:是 |
文档更新时间: 2023-03-14 17:04 作者:admin