一、业务背景
现在很多返利小程序、内容导购站点、渠道分销系统，都需要接入第三方电商平台商品数据，依托 CPS 模式获取成交佣金。 业务核心诉求：获取商品标题、图片、规格、实时售价、优惠券、佣金比例、推广跳转链接，对外完成商品展示；用户通过推广链接下单后，完成渠道统计、佣金核算、分销分账整套流程。
部分开发者初期会选择网页抓取的方式获取商品数据，但爬虫会遇到页面改版、IP 限制、数据延迟等一系列问题，后期维护成本很高。使用开放 API 可以拿到标准化 JSON 结构化数据，稳定性更强，更适合商用项目长期运行。
这里需要区分两类接口：联盟侧商品详情接口适配推广分销业务，自带佣金、推广链接字段；JOS 商家接口主要服务店铺内部管理，缺少联盟推广相关数据，不适合 CPS 导购场景。
二、整体业务流程梳理
基于京东商品详情 API 搭建导购分销业务，完整链路分为 5 个环节：
商品数据请求：传入 SKU 编号调用详情接口，拉取商品完整返回数据。
数据处理清洗：对返回结果做合法性校验，解析价格、优惠券、佣金字段，过滤无效数据，落地存储到数据库，搭配缓存策略。
推广链接加工：基于接口返回原始推广地址，拼接业务推广位、渠道标记，实现不同分销渠道订单归因。
订单佣金闭环：商品详情接口仅提供商品基础物料，订单、结算数据需要单独调用联盟订单接口，完成对账、分账逻辑。
基础信息
接口名称：jd .item.get（（京东商品详情 API，taobaoapi2014 前往体验））
正式网关：c0b.cc/R4rbK2
请求协议：HTTPS，推荐 POST
返回格式：JSON（默认），支持 XML
版本：v2.0
核心字段解析
商品基础信息：skuId、商品名称、主图、详情图、类目、规格参数，用于前端页面渲染展示。
价格促销字段：京东售价、到手价、优惠券列表、满减活动。这里需要注意，原始标价不等于用户实际支付价格，需要叠加优惠券、满减之后，计算预估到手价，给到终端用户参考。
佣金相关字段：佣金比例、预估佣金金额。该数值为参考值，真实佣金以最终成交订单接口返回结果为准。
三、导购分销场景核心数据处理要点
接口返回字段数量庞大，导购业务不需要全部解析，重点处理四类核心数据：
商品基础物料 skuId、商品标题、主图、轮播图、类目、规格参数。用于前端页面渲染展示。接口入参仅支持 SKU，SPU 编号无法查询商品详情，同一个 SPU 对应多个 SKU 规格，业务层需要做好 SKU 维度管理。
价格与促销数据 接口返回京东售价、优惠券列表、满减活动。原始标价不等于用户实际支付价格，业务代码需要结合各类优惠计算预估到手价。前端页面务必标注价格仅为参考，实际下单价格以京东页面为准。
联盟佣金数据 佣金比例、预估佣金金额。大促期间商品佣金会动态变化，接口返回属于预估数值，会存在波动，不能直接拿来做最终结算。
推广归因数据 原始联盟推广 URL。业务系统需要追加推广位 ID、渠道标识，用来区分不同推广人员、不同渠道带来的订单，保障佣金正常归属。
