京东商品详情 API 完整解析 + 标准 JSON 返回示例

原创

Anzexi58

发布于 2026-07-16 10:16:46

850

文章被收录于专栏：API接口开发API接口开发

本文以京东联盟开放接口 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：商品唯一 ID
title：商品标题
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：子规格 ID
specText：规格名称（颜色 + 尺码）
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 地址，可直接展示使用

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

登录后参与评论

0 条评论

热度

京东商品详情 API 完整解析 + 标准 JSON 返回示例

京东商品详情 API 完整解析 + 标准 JSON 返回示例

本文以京东联盟开放接口 jd.union.open.goods.detail.query 为例，完整说明接口结构、字段含义、业务用途，并提供可直接用于开发调试的标准 JSON 返回示例。

一、接口基本信息

二、标准 JSON 成功返回示例（完整版）

三、顶层结构解析

四、核心业务字段详解

1. 商品基础信息

2. 价格体系（比价 / 导购核心）

3. 佣金信息（CPS 分销核心）

4. 销量与库存（铺货 / ERP 核心）

5. 图片素材（商品搬家 / 建站必备）

6. SKU 规格（多规格商品必解析）

7. 商品参数（详情展示 / 参数对比）

8. 评价概况（选品 / 口碑分析）

五、常见异常 JSON 示例

1. skuId 不存在或商品已下架

2. 签名错误

3. 请求频率超限（限流）

六、开发注意要点

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐