查询商品详情
使用场景：查询抖店商品详情信息
1、支持使用抖店商品id
2、商品外部开发者自定义编码查询
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳，秒 |
| seller_nick | String | 是 | 38173182 | 抖店的账号，对应蜂巢授权返回doudianseller字段 |
| sign | String | 是 |
业务参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| product_id | - | 否 | 3558192687276554544 | 商品ID，抖店系统生成，店铺下唯一；长度19位 |
| out_product_id | String | 否 | dy001 | 外部商家编码，商家自定义字段 |
| show_draft | String | 否 | false | true：读取草稿数据；false：读取线上数据；不传默认为false |
| store_id | - | 否 | 1111420330 | 门店ID，不建议小时达一期用，即时零售单店版，无需使用 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void DDProductDetail() throws Exception {
Map<String, Object> data = new HashMap<String, Object>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("seller_nick", Config.DDSellerNick);
data.put("product_id","3684948274437030273" );
// data.put("out_product_id","dy001" );
data.put("show_draft","false" );
// data.put("store_id","158458425" );
data.put("sign", Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.DDProductDetail, data);
System.out.println(resp);
}
3. 返回结果如下：
{
"code": 0,
"message": "ok",
"data": {
"account_template_id": null,
"after_sale_service": "{\"supply_7day_return\":\"1\",\"supply_day_return_code\":\"1\",\"supply_day_return_copywriting\":\"7天无理由退货\",\"supply_day_return_days\":\"7\",\"supply_day_return_selector\":\"7-1\"}",
"after_sale_service_v2": {
"is_large_product": null
},
"appoint_delivery_day": 0,
"brand_id": null,
"car_vin_code": null,
"category_detail": {
"first_cid": 20005,
"first_cname": "女装",
"fourth_cid": 0,
"fourth_cname": "",
"second_cid": 20219,
"second_cname": "半身裙",
"third_cid": 0,
"third_cname": ""
},
"cdf_category": null,
"check_status": 1,
"create_time": "2024-05-17 17:50:34",
"delay_rule": {
"config_type": 0,
"config_value": 0,
"enable": false,
"end_time": 0,
"start_time": 0
},
"delivery_delay_day": 2,
"delivery_method": null,
"description": "\u003cp\u003e\u003cimg src=\"https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_ALSUvYM_70526582776577067660798_51d5ff356da0f3664980f84a9029bedb_sx_24925_www800-800\" style=\"max-width:100%;\"/\u003e\u003c/p\u003e",
"discount_price": 1,
"draft_status": 0,
"extra": "{\"category_detail\":{\"enable\":null,\"first_cid\":20005,\"first_cname\":\"女装\",\"fourth_cid\":0,\"fourth_cname\":\"\",\"is_leaf\":true,\"second_cid\":20219,\"second_cname\":\"半身裙\",\"third_cid\":0,\"third_cname\":\"\"},\"class_quality\":\"\",\"is_publish\":1,\"quality_opId\":\"7371374578486214963\",\"quality_report\":\"\",\"spec_seq_info\":{\"child_spec_seq\":[\"颜色分类\",\"尺码大小\"],\"spec_values_seq\":[[\"白色\"],[\"M\"]]}}",
"format_update_time": "2024-05-21 17:37:43",
"freight_id": 0,
"img": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_ALSUvYM_70630259408755264040798_16991a88a61d1a1f4ab8bc526fcb7762_sx_388998_www800-800",
"is_create": 0,
"is_sub_product": false,
"limit_per_buyer": 0,
"logistics_info": {
"brand_country_id": 0,
"customs_clear_type": 0,
"net_weight_qty": 0,
"origin_country_id": 0,
"source_country_id": 0,
"tax_payer": 0
},
"long_pic_url": null,
"main_image_three_to_four": "[]",
"main_pic_3_4": [],
"main_product_id": null,
"market_price": 1,
"material_video_id": null,
"maximum_per_order": 0,
"micro_app_id": null,
"minimum_per_order": 1,
"mobile": "400123456",
"name": "测试商品－请勿购买-女装",
"name_prefix": null,
"name_suffix": null,
"need_recharge_mode": false,
"open_user_id": 0,
"out_product_id": 0,
"outer_product_id": "",
"pay_type": 1,
"pic": ["https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_ALSUvYM_70630259408755264040798_16991a88a61d1a1f4ab8bc526fcb7762_sx_388998_www800-800", "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/ALSUvYM_m_1ca7af9ff5adb5687879c18484d72777_sx_190683_www800-800", "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_ALSUvYM_70526582776577067660798_51d5ff356da0f3664980f84a9029bedb_sx_24925_www800-800"],
"pickup_method": "0",
"presell_config_level": null,
"presell_delay": 0,
"presell_delivery_type": null,
"presell_end_time": null,
"presell_type": 0,
"price_has_tax": 0,
"product_audit_info": {
"material_audit_reason": [],
"material_audit_status": null
},
"product_format": "",
"product_format_new": "{\"1551\":[{\"Value\":22064,\"Name\":\"超短裙\",\"PropertyId\":1551,\"PropertyName\":\"裙长\",\"diy_type\":0,\"measure_info\":null}],\"1878\":[{\"Value\":16521,\"Name\":\"高腰\",\"PropertyId\":1878,\"PropertyName\":\"腰型\",\"diy_type\":0,\"measure_info\":null}],\"241\":[{\"Value\":0,\"Name\":\"常规款\",\"PropertyId\":241,\"PropertyName\":\"厚度\",\"diy_type\":1,\"measure_info\":null}],\"2592\":[{\"Value\":0,\"Name\":\"甜美风\",\"PropertyId\":2592,\"PropertyName\":\"风格\",\"diy_type\":1,\"measure_info\":null}],\"785\":[{\"Value\":0,\"Name\":\"亚麻100%\",\"PropertyId\":785,\"PropertyName\":\"面料材质\",\"diy_type\":1,\"measure_info\":{\"template_id\":252,\"values\":[{\"module_id\":582,\"value\":\"亚麻\",\"unit_id\":0,\"unit_name\":\"\",\"prefix\":\"\",\"suffix\":\"\"},{\"module_id\":583,\"value\":\"100\",\"unit_id\":15,\"unit_name\":\"%\",\"prefix\":\"\",\"suffix\":\"\"}]}}],\"981\":[{\"Value\":22253,\"Name\":\"蛋糕裙\",\"PropertyId\":981,\"PropertyName\":\"裙型\",\"diy_type\":0,\"measure_info\":null}]}",
"product_id": 3684948274437030273,
"product_id_str": "3684948274437030273",
"product_type": 0,
"quality_list": [],
"recommend_remark": "",
"reduce_type": 1,
"reference_price": 0,
"sale_channel_type": null,
"sale_limit_id": null,
"sell_channel": [0],
"sell_num": 0,
"short_product_name": "",
"size_info_template_id": 7369486293141373223,
"spec_id": 1799292907865225,
"spec_pics": [],
"spec_prices": [{
"code": "这个就是抖店后台的sku商家编码",
"customs_report_info": {
"bar_code": "",
"first_measure_qty": 0,
"first_measure_unit": "",
"g_model": "",
"hs_code": "",
"report_brand_name": "",
"report_name": "",
"second_measure_qty": 0,
"second_measure_unit": "",
"unit": "",
"usage": ""
},
"delivery_infos": [],
"gold_process_charge": null,
"lock_step_stock_num": 0,
"lock_stock_num": 0,
"out_sku_id": 0,
"outer_sku_id": "",
"presell_delay": null,
"price": 1,
"prom_step_stock_num": 0,
"prom_stock_num": 0,
"promotion_step_stock_num": null,
"promotion_stock_num": null,
"sell_properties": [{
"perperty_id": 2752,
"property_name": "颜色分类",
"remark": "",
"value_id": 35497,
"value_name": "白色",
"value_spec_detail_id": 1799292907865257
}, {
"perperty_id": 4704,
"property_name": "尺码大小",
"remark": "",
"value_id": 12924,
"value_name": "M",
"value_spec_detail_id": 1799292908009540
}],
"sku_classification_type": null,
"sku_id": 3404736797159426,
"sku_status": true,
"sku_type": 0,
"spec_detail_id1": 1799292907865257,
"spec_detail_id2": 1799292908009540,
"spec_detail_id3": 0,
"spec_detail_ids": [1799292907865257, 1799292908009540],
"step_stock_num": 0,
"stock_num": 11,
"stock_num_map": null,
"supplier_id": "",
"tax_exemption_sku_info": {
"is_suit": null,
"suit_num": null,
"volume": null
}
}],
"specs": [{
"id": 1799292907865241,
"is_leaf": 0,
"name": "颜色分类",
"pid": 0,
"property_id": 2752,
"spec_id": 1799292907865225,
"values": [{
"extra": {
"cpv_path": [{
"cpid": 4471,
"cpvid": 7054
}, {
"cpid": 2752,
"cpvid": 35497
}]
},
"id": 1799292907865257,
"is_leaf": 1,
"name": "白色",
"pid": 1799292907865241,
"spec_id": 1799292907865225,
"status": 0,
"value_id": "35497"
}]
}, {
"id": 1799292907865273,
"is_leaf": 0,
"name": "尺码大小",
"pid": 0,
"property_id": 4704,
"spec_id": 1799292907865225,
"values": [{
"extra": {
"cpv_path": [{
"cpid": 4705,
"cpvid": 231118
}, {
"cpid": 4704,
"cpvid": 12924
}]
},
"id": 1799292908009540,
"is_leaf": 1,
"name": "M",
"pid": 1799292907865273,
"spec_id": 1799292907865225,
"status": 0,
"value_id": "12924"
}]
}],
"spu_id": 0,
"standard_brand_id": 596120136,
"start_sale_type": 0,
"status": 1,
"store_id": 0,
"update_time": "2024-05-21T17:37:43+08:00",
"weight_unit": 1,
"weight_value": 0,
"white_back_ground_pic_url": null
}
}q
说明： code为0表示成功，非0为失败，message会包含失败原因。返回字段说明见文档
https://op.jinritemai.com/docs/api-docs/14/56
文档更新时间: 2024-05-22 11:22 作者：JSL
