技术实战：微店商品详情API接口接入指南与JSON返回参考
前言
在私域电商运营、多平台铺货、商品数据聚合的业务场景中，微店商品详情API是开发者和私域从业者最核心的结构化数据入口。它无需搭建复杂的页面爬虫体系，就能稳定获取全维度的微店商品信息，大幅降低私域电商相关业务的开发门槛，是打通微店数据与自有系统的必备工具。
一、接口核心覆盖的数据范围
这套接口可以返回私域电商业务开发中几乎所有需要的微店商品核心字段，完全适配商品同步、库存监控、选品分析等多种场景：
基础标识：商品唯一ID、商品标题、所属店铺ID、店铺名称、商品发布时间、商品所属分类路径
价格体系：商品划线价、实时售价、会员专享价、优惠券抵扣金额、拼团活动价，数据支持分钟级更新
交易属性：总销量、累计浏览量、商品库存总量、已售数量、发货地、承诺发货时效
规格库存：全SKU列表、每个子规格的对应价格、实时可售库存、颜色/尺寸/型号等属性明细
素材资源：多尺寸主图数组、详情图列表、商品详情页HTML素材链接、短视频素材地址
附加信息：商品参数详情、售后保障政策、分销佣金比例、关联推广链接、商品标签列表
二、最简接入操作步骤
新手跟着3步就能完成基础调用，没有复杂的前置依赖：
登录微店开放平台，创建开发者应用，开通商品详情查询接口权限，获取专属的App Key和App Secret（o0b.cn/anzexi）
按照官方规范生成合法签名，将所有非空请求参数按字典序排序后拼接密钥，通过MD5加密生成验签值
用HTTPS POST方式将请求提交到微店API网关，传入目标商品ID，即可直接返回标准JSON格式的结构化商品数据
三、可直接参考的成功返回JSON示例
这是脱敏后的标准返回结构，完全匹配微店开放平台官方商品详情接口的原生返回格式，核心字段都标注了业务含义，可直接用于开发调试参考：
{
"code": 0,
"msg": "success",
"request_id": "req_2026081211472398",
"data": {
"item_id": 123456789,
"title": "2026新款手工纯棉文艺风连衣裙 夏季透气中长款 多色可选",
"desc": "采用100%新疆长绒棉面料，亲肤透气不闷汗，宽松版型不挑身材，日常通勤出游都能穿，支持7天无理由退换",
"shop_info": {
"shop_id": 987654321,
"shop_name": "棉麻文艺小铺",
"shop_type": "个人店铺",
"is_verified": true
},
"price_info": {
"original_price": "199.00",
"current_price": "89.00",
"vip_price": "79.00",
"coupon_price": "69.00",
"coupon_desc": "满89减20店铺专属券"
},
"sales_info": {
"total_sales": 12680,
"month_sales": 1860,
"view_count": 156890
},
"stock_info": {
"total_stock": 3260,
"is_on_sale": true,
"delivery_place": "浙江杭州",
"delivery_time": "48小时内发货"
},
"image_info": {
"main_images": [
"https://img.wdimg.com/123/456/abc123_1.jpg",
"https://img.wdimg.com/123/456/abc123_2.jpg",
"https://img.wdimg.com/123/456/abc123_3.jpg"
],
"detail_images": [
"https://img.wdimg.com/123/456/def456_1.jpg",
"https://img.wdimg.com/123/456/def456_2.jpg"
],
"video_url": "https://v.wdimg.com/123/ghi789.mp4"
},
"sku_list": [
{
"sku_id": 12345678901,
"spec_text": "米白色 S",
"sku_price": "89.00",
"sku_stock": 860
},
{
"sku_id": 12345678902,
"spec_text": "雾霾蓝 M",
"sku_price": "89.00",
"sku_stock": 920
},
{
"sku_id": 12345678903,
"spec_text": "浅灰色 L",
"sku_price": "89.00",
"sku_stock": 1480
}
],
"product_params": [
{"name": "面料成分", "value": "100%长绒棉"},
{"name": "版型", "value": "宽松A字版"},
{"name": "适用季节", "value": "夏季"}
],
"promotion_info": {
"commission_rate": 12.0,
"commission_money": "8.28",
"promotion_url": "https://k.weidian.com/xyz789"
},
"tags": [
"手工制作",
"纯棉透气",
"文艺风"
],
"after_sale": {
"support_return": true,
"return_days": 7,
"support_insurance": true
}
}
}