一、接口定位

京东商品详情数据接口（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返回参考

{
  "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
        }
      }
    }
  }
}