本文以京东联盟开放接口 jd.union.open.goods.detail.query 为例，完整说明接口结构、字段含义、业务用途，并提供可直接用于开发调试的标准 JSON 返回示例。
一、接口基本信息
- 接口名称：
jd.union.open.goods.detail.query - 请求方式：POST
- 数据格式：JSON
- 身份校验：
appKey + appSecret签名 - 必传参数：
skuId（京东商品 ID） - 适用场景：商品采集、铺货搬家、价格监控、导购分销、ERP 同步、选品分析
二、标准 JSON 成功返回示例（完整版）
{ "jd_union_open_goods_detail_query_response": { "code": "0", "msg": "success", "requestId": "req_2026071600123456", "result": { "goodsInfo": { "skuId": "100012345678", "title": "2026新款夏季纯棉短袖T恤宽松百搭男女同款上衣", "brandName": "XX品牌", "categoryName": "服饰内衣 > 男装 > T恤", "shopName": "XX官方旗舰店", "shopType": "third", "isJdSelf": false, "itemUrl": "https://item.jd.com/100012345678.html", "priceInfo": { "originalPrice": "99.00", "discountPrice": "59.00" }, "couponInfo": { "hasCoupon": true, "couponDiscount": "10.00", "finalPrice": "49.00", "couponDesc": "满59减10元" }, "commissionInfo": { "commissionRate": "10.00", "commissionMoney": "4.90" }, "salesInfo": { "totalSales": 12580, "monthSales": 3210 }, "stockInfo": { "totalStock": 950, "isSale": true }, "imageInfo": { "mainImg": "https://img10.360buyimg.com/xxx/main.jpg", "detailImgList": [ "https://img10.360buyimg.com/xxx/d1.jpg", "https://img10.360buyimg.com/xxx/d2.jpg" ] }, "skuList": [ { "skuId": "10001234567801", "specText": "白色 M", "skuPrice": "59.00", "skuStock": 320 }, { "skuId": "10001234567802", "specText": "黑色 XL", "skuPrice": "59.00", "skuStock": 285 } ], "productParams": [ { "name": "面料", "value": "100%棉" }, { "name": "版型", "value": "宽松型" }, { "name": "适用季节", "value": "夏季" } ], "commentSummary": { "goodRateShow": "97.2", "commentCount": 1860, "goodCount": 1780, "generalCount": 50, "poorCount": 30 } } } } }
三、顶层结构解析
code：返回状态码，0表示成功msg：返回信息说明requestId：请求唯一标识，用于排查问题result.goodsInfo：商品详情核心数据体
四、核心业务字段详解
1. 商品基础信息
skuId：商品唯一 IDtitle：商品标题brandName：品牌名称categoryName：类目名称shopName：店铺名称isJdSelf：是否京东自营itemUrl：商品详情页链接
2. 价格体系（比价 / 导购核心）
originalPrice：原价discountPrice：京东当前售价couponInfo.hasCoupon：是否有券couponDiscount：优惠金额finalPrice：券后到手价
3. 佣金信息（CPS 分销核心）
commissionRate：佣金比例commissionMoney：预估佣金
4. 销量与库存（铺货 / ERP 核心）
totalSales：总销量monthSales：近 30 天销量totalStock：总库存isSale：是否可售
5. 图片素材（商品搬家 / 建站必备）
mainImg：商品主图detailImgList：详情图列表
6. SKU 规格（多规格商品必解析）
skuId：子规格 IDspecText：规格名称（颜色 + 尺码）skuPrice：规格单价skuStock：规格库存
7. 商品参数（详情展示 / 参数对比）
name：参数名称value：参数值
8. 评价概况（选品 / 口碑分析）
goodRateShow：好评率commentCount：总评论数goodCount/generalCount/poorCount：好评 / 中评 / 差评数量
五、常见异常 JSON 示例
1. skuId 不存在或商品已下架
{ "jd_union_open_goods_detail_query_response": { "code": "400", "msg": "skuId不存在或商品已下架", "requestId": "req_2026071600112233" } }
2. 签名错误
{ "jd_union_open_goods_detail_query_response": { "code": "15", "msg": "签名校验失败", "requestId": "req_2026071600114455" } }
3. 请求频率超限（限流）
{ "jd_union_open_goods_detail_query_response": { "code": "429", "msg": "请求过于频繁，请稍后重试", "requestId": "req_2026071600116677" } }
六、开发注意要点
- 价格字段均为字符串，计算时需转为数字类型
skuList、detailImgList、productParams可能为空数组，必须做判空处理- 库存存在延迟，高并发下单建议在下单前再次实时校验
- 批量采集建议使用分级轮询，避免触发限流
- 商品图片为京东 CDN 地址，可直接展示使用
