摘要：在私域 ERP 系统开发、微店店铺搬家、分销选品、多店铺商品数据同步业务场景中，需要完整获取微店平台商品结构化数据。micro.item_get微店商品详情 API，传入商品item_id，可以拿到商品标题、价格体系、SKU 规格、图文素材、分销信息、店铺信息、库存状态等完整业务字段。本文从接口概述、请求入参、返回字段解析、标准 JSON 样例、业务处理流程、工程踩坑、落地场景完整讲解，适合私域电商后端、ERP、数据同步开发者参考。
一、接口概述
micro.item_get微店商品详情接口，是微店开放平台核心数据接口。商品列表接口仅返回商品摘要，SKU 明细、富文本详情、分销佣金、运费模板、真实在售状态。
接口名称：micro.item_get（微店商品详情API，taobaoapi2014前往体验）
接口版本：2.0
调用限制：存在单秒频次、每日调用配额，高频场景需做限流、缓存 处理。接口能力覆盖
商品基础元数据：标题、副标题、售价、划线价、促销价
SKU 规格体系：规格名称、SKU 图片、单品价格、SKU 库存
多媒体资源：主图数组、详情 HTML 富文本
交易物流：总库存、累计销量、运费、是否包邮
私域特有字段：分销佣金比例、分销开关状态
店铺信息：店铺 ID、店铺名称、店铺认证标识
商品状态：在售 / 下架标记
二、核心请求入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| item_id | string | 是 | 微店商品唯一 ID，来源于商品列表接口返回值 |
| access_token | string | 是 | OAuth 授权访问令牌，需定时刷新 |
| app_key | string | 是 | 开发者应用密钥 |
| timestamp | long | 是 | 秒级时间戳，用于防重放攻击 |
| sign | string | 是 | HMAC‑SHA256 生成接口签名，参数名 ASCII 升序拼接加密 |
三、返回数据结构解析
顶层响应结构
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 0调用成功；非 0 为异常错误码 |
| msg | string | 响应描述，成功返回success，失败输出错误原因 |
| request_id | string | 请求唯一 ID，线上日志排查使用 |
| data | object | 商品详情业务主体对象 |
data 商品主体字段
| 字段 | 类型 | 说明 |
|---|---|---|
| item_id | string | 微店商品唯一 ID |
| title | string | 商品主标题 |
| sub_title | string | 商品副标题 |
| price | float | 商品销售价格 |
| market_price | float | 划线原价 |
| vip_price | float | 会员价，无会员价返回 0 |
| stock | int | 商品总库存 |
| sales | int | 累计销量 |
| is_on_sale | int | 商品状态：1 在售，0 下架 |
| main_images | arraystring | 商品主图数组 |
| desc_html | string | 商品详情富文本 HTML |
| sku_list | arrayobject | SKU 规格数组 |
| is_distribution | boolean | 是否开启分销 |
| commission_rate | float | 分销佣金比例，关闭分销返回 0 |
| post_fee | float | 运费金额 |
| is_free_shipping | boolean | 是否包邮 |
| shop_id | string | 店铺 ID |
| shop_name | string | 店铺名称 |
| is_shop_verified | boolean | 店铺是否认证 |
| category_id | string | 微店内部分类 ID |
sku_list SKU 规格对象
| 字段 | 类型 | 说明 |
|---|---|---|
| sku_id | string | SKU 唯一编号 |
| spec_name | string | 规格组合名称，例：黑色 / L 码 |
| sku_pic | string | SKU 规格图片地址 |
| sku_price | float | 该 SKU 销售价格 |
| sku_stock | int | 该 SKU 库存数量 |
