一、接口基础简介

请求基础信息：

接口名称：micro.item_get（微店商品详情API，taobaoapi2014前往体验）

请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

接口版本：2.0

入参：item_id商品 ID，token 访问凭证

输出：微店商品基础信息、图片、价格、SKU 库存、店铺、分销营销、商品参数等结构化 JSON 数据

适用场景：私域 ERP、跨平台商品迁移、价格监控、内部选品报表

鉴权：token 签名校验，token 具备有效期；存在 QPS 限流，批量调用需要控频。

二、顶层公共响应字段

用于判断请求状态，排查异常、日志定位。

字段类型说明业务用途

codeString状态码，0代表请求成功判断接口调用是否正常

msgString响应描述文本排查 token 失效、商品下架、权限不足、限流报错

request_idString本次请求唯一 ID线上问题排查、日志溯源

dataObject商品业务数据主体对象解析货源数据的根对象

三、data 商品主体核心字段

字段类型说明 & 业务场景

item_id / num_iidString商品全局唯一 ID；做缓存 key、数据主键、二次接口入参

titleString商品完整标题；商品同步、检索展示

descString商品详情富文本 HTML；跨平台刊登需要清洗 HTML 标签，防范 XSS 风险

desc_shortString商品简短简介；列表页摘要展示

main_imagesArray主图 URL 数组；跨平台刊登素材，注意防盗链

slide_imagesArray轮播附图数组；详情页素材同步

videoString商品短视频地址；有短视频业务可同步素材

priceString当前售卖价格；展示成交售价

market_price / original_priceString划线原价；用于页面划线价展示

post_feeString运费；核算完整成交成本

stockInt商品总可售库存；库存同步、库存预警判断

salesInt累计销量；判断商品热度，数据分析参考

browse_numInt商品浏览量；运营数据分析

statusInt商品状态：1 上架，0 下架，2 售罄；同步业务过滤已下架商品

category_idString微店内部分类 ID；用于类目映射转换

props_listArray商品属性参数数组，[{name:"材质",value:"纯棉"}]；刊登商品属性回填

is_virtualBoolean是否虚拟商品；虚拟商品无实物发货逻辑，业务区分

is_promotionBoolean是否参与促销活动；识别限时折扣、活动价

create_timeString商品创建时间；商品上新统计

update_timeString商品最后更新时间；增量同步判断依据

detail_urlString微店商品 H5 详情链接；人工复核入口

四、店铺信息子字段 data.shop

字段类型说明业务用途

shop_idString店铺唯一 ID；多店铺数据隔离存储

shop_nameString店铺名称；来源展示、商家筛选

seller_nickString卖家账号昵称；运营统计

seller_areaString发货地区；评估物流成本、产业带筛选

五、skus  SKU 规格数组（业务重点）

多规格商品核心解析对象，服饰、多配件类商品必须解析该数组。

字段类型说明

sku_idString规格唯一 ID；SKU 主键

spec_nameString规格名称，例：黑色 / L 码

sku_priceString该规格实际售价；多 SKU 不要直接取外层 price

sku_stockInt该规格可售库存；库存同步核心字段

sku_imageString规格对应的图片地址；规格图素材同步

min_buy_numInt该规格最小购买数量

六、promotion_info 分销营销子对象（微店私域特有）

字段类型说明

commission_rateFloat分销佣金比例；分销系统计算佣金使用

commission_moneyString预估佣金金额

promotion_urlString分销推广链接；分销业务场景使用