一、前置说明
很多开发者接入京东商品详情接口后最头疼三个数据:多 SKU 规格映射、真实券后到手价、实时库存。接口原始返回字段嵌套层级深,促销、满减、优惠券分散在不同节点,直接取 price 字段很容易拿到标价,不是用户最终成交价;库存也区分仓库存、可售、预售库存,不做处理容易失真。
二、整体返回结构概览
API接口名称:jd.item_get(Taobaoapi2014前往体验);
理解接口限流频次、权限范围,不同应用权限可返回字段存在差异。
接口返回主体一般包含:商品基础信息、sku 集合、促销集合、优惠券列表、库存节点。 核心链路:goodsInfo → skuList(SKU 数组)、promotionInfo(促销活动)、couponInfo(优惠券)、stockInfo(库存)
三、SKU 相关字段拆解
核心字段
skuId:SKU 唯一 ID,查询价格、库存、下单都依赖这个 id
skuName:SKU 规格名称(颜色、尺寸、版本等)
skuPic:SKU 对应缩略图
originalPrice:SKU 原价 / 划线价
price:联盟价 / 销售标价(不等于券后价)
skuStatus:SKU 状态,1 = 正常可售,0 = 下架
提取思路
遍历 skuList 数组,以 skuId 作为主键建立映射表;
把规格名称做结构化拆分,例如 颜色:黑色;容量:256G,方便存入数据库用于筛选;
过滤掉下架 SKU,避免无效数据入库;
注意:同一个 spu 下不同 sku 的价格、库存、促销相互独立,不能拿 SPU 价格覆盖所有 SKU。