摘要：私域场景下微店沉淀大量商品、SKU、库存、营销价格数据，不少 ERP、店铺搬家、数据分析，统需要拉取微店商品结构化信息。本文从工程实战角度讲解micro.item_get微店商品详情API，梳理调用鉴权、入参、返回字段解析、SKU 多规格处理、数据同步逻辑，同时整理 token 失效、版本兼容、限流等线上踩坑，可供私域工具、多店铺管理系统开发参考。
一、业务背景：为什么需要对接微店商品详情接口
微店作为主流私域开店载体，大量中小商家在上面上架货源、做社群分销、私域成交。在实际开发中经常遇到这些需求：
将微店商品批量同步到其他商城系统，实现店铺搬家；
ERP 系统读取微店的 SKU、库存、价格，做统一库存管理；
数据分析场景，抓取商品标题、主图、销量、营销活动做竞品调研；
内部后台聚合多店铺商品，做选品、报表统计。
如果采用网页爬虫 方式获取页面数据，会面临页面改版、反爬、HTML 解析繁琐、维护成本高等问题。调用官方风格的商品详情接口micro.item_get，直接获取结构化 JSON 数据，稳定性更高，便于业务系统对接。
二、接口基础说明
接口标识：micro.item_get 微店商品详情 API（微信商品详情API，taobaoapi2014前往体验）
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
接口版本：2.0
基础元数据：SPU 商品 ID、skuId、商品标题、品牌、类目、售卖状态、货号
媒体资源：主图数组、详情图片、商品短视频素材
SKU 规格数据：规格名称、各 SKU 售价、促销价、库存状态、限购规则
商品属性参数：产品规格、材质、包装清单等属性信息
附属业务信息：促销标签、市场参考价、区域限制相关字段
原始 JSON 报文嵌套层级较深，拿到原始数据不能直接投入业务，需要解析、清洗、结构重组之后再持久化。
核心能力：传入商品 ID，返回微店商品完整结构化数据：基础信息、图片、价格、SKU 规格、库存、销量、店铺信息、营销活动等。
适用业务场景：私域 ERP 对接、商品跨系统同步、店铺搬家、商品数据分析、内部报表统计。
鉴权方式：token 签名校验，token 存在有效期，需要做过期刷新逻辑。
限制：存在 QPS 限流，单店铺调用频率有约束，批量同步需要控制请求间隔。
