京东商品详情 API 完整解析 + 标准 JSON 返回示例
本文以京东联盟开放接口 jd.union.open.goods.detail.query 为例，完整说明接口结构、字段含义、业务用途，并提供可直接用于开发调试的标准 JSON 返回示例。
一、接口基本信息
接口名称：
jd.union.open.goods.detail.query请求方式：POST
数据格式：JSON
身份校验：
appKey + appSecret签名必传参数：
skuId（京东商品 ID）适用场景：商品采集、铺货搬家、价格监控、导购分销、ERP 同步、选品分析
二、标准 JSON 成功返回示例（完整版）
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 不存在或商品已下架
json
{
"jd_union_open_goods_detail_query_response": {
"code": "400",
"msg": "skuId不存在或商品已下架",
"requestId": "req_2026071600112233"
}}2. 签名错误
json
{
"jd_union_open_goods_detail_query_response": {
"code": "15",
"msg": "签名校验失败",
"requestId": "req_2026071600114455"
}}3. 请求频率超限（限流）
json
{
"jd_union_open_goods_detail_query_response": {
"code": "429",
"msg": "请求过于频繁，请稍后重试",
"requestId": "req_2026071600116677"
}}六、开发注意要点
价格字段均为字符串，计算时需转为数字类型
skuList、detailImgList、productParams可能为空数组，必须做判空处理库存存在延迟，高并发下单建议在下单前再次实时校验
批量采集建议使用分级轮询，避免触发限流
商品图片为京东 CDN 地址，可直接展示使用
