查询商品详情

一、请求参数

使用场景：查询抖店商品详情信息 1、支持使用抖店商品id 2、商品外部开发者自定义编码查询

请求URL:

POST https://kf.fw199.com/gateway/dd/product/detail

公共参数

参数名称	参数类型	是否必须	示例值	参数描述
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，不建议小时达一期用，即时零售单店版，无需使用
sysid	String	是	12345	咨询客服

二、请求示例代码

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("sysid","xx" );
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDProductDetail, data);
        System.out.println(resp);
    }

三、返回结果

{
    "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