首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >京东商品详情数据接口:简版接入指南与JSON返回参考

京东商品详情数据接口:简版接入指南与JSON返回参考

原创
作者头像
Anzexi58
发布于 2026-10-13 17:06:39
发布于 2026-10-13 17:06:39
100
举报
文章被收录于专栏:API接口开发API接口开发

一、接口定位

京东商品详情数据接口(jd.union.open.goods.detail.query)是京东开放平台的核心数据入口。传入一个商品 SKU ID,即可返回标题、价格、优惠券、库存、SKU规格、图片、评价等全维度结构化数据,适用于商品同步、比价监控、选品分析等场景。

二、接入三步

  1. 拿密钥:在京东开放平台创建应用,获取 AppKey 和 AppSecret,并申请商品详情查询权限。密钥o0b.cn/anzexi
  2. 算签名:把非空参数按参数名 ASCII 升序排序,只拼接各参数的 value,首尾各加一次 AppSecret,做 MD5 后转大写。
  3. 发请求:以 HTTPS POST 提交到网关 https://api.jd.com/routerjson,核心业务参数为 skuId。

提醒:时间戳格式必须是 yyyy-MM-dd HH:mm:ss(东八区),与服务器时间偏差超过 10 分钟会被直接拒绝。

三、标准JSON返回参考

代码语言:javascript
复制
{
  "jd_union_open_goods_detail_query_response": {
    "code": "0",
    "msg": "success",
    "requestId": "req_20261012164533120",
    "result": {
      "goodsInfo": {
        "skuId": "100012345678",
        "spuId": "100012345600",
        "title": "2026夏季新款纯棉短袖T恤 男女同款宽松版",
        "brandName": "XX品牌",
        "shopName": "XX官方旗舰店",
        "isJdSelf": false,
        "itemUrl": "https://item.jd.com/100012345678.html",

        "priceInfo": {
          "originalPrice": "99.00",
          "discountPrice": "59.00",
          "lowestPrice30Days": "55.00"
        },

        "couponInfo": {
          "hasCoupon": true,
          "finalPrice": "49.00",
          "couponList": [
            {
              "couponId": "cp20261012001",
              "couponDiscount": "10.00",
              "couponDesc": "满59减10元店铺券",
              "endTime": "2026-10-31 23:59:59"
            }
          ]
        },

        "stockInfo": {
          "totalStock": 950,
          "isSale": true,
          "stockStatus": "in_stock"
        },

        "salesInfo": {
          "totalSales": 12580,
          "monthSales": 3210
        },

        "imageInfo": {
          "mainImg": "https://img10.360buyimg.com/n1/jfs/t1/xxx/main.jpg",
          "detailImgList": [
            "https://img10.360buyimg.com/n1/jfs/t1/xxx/d1.jpg",
            "https://img10.360buyimg.com/n1/jfs/t1/xxx/d2.jpg"
          ]
        },

        "skuList": [
          {
            "skuId": "10001234567801",
            "specText": "白色 M",
            "specs": [
              {"name": "颜色", "value": "白色"},
              {"name": "尺码", "value": "M"}
            ],
            "skuPrice": "59.00",
            "skuStock": 320,
            "isAvailable": true
          },
          {
            "skuId": "10001234567803",
            "specText": "红色 S",
            "skuPrice": "59.00",
            "skuStock": 0,
            "isAvailable": false
          }
        ],

        "productParams": [
          {"name": "面料", "value": "100%棉"},
          {"name": "版型", "value": "宽松型"}
        ],

        "commentSummary": {
          "goodRateShow": "97.2",
          "commentCount": 1860
        }
      }
    }
  }
}

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

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

目录
  • 二、接入三步
  • 三、标准JSON返回参考
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档