首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >技术入门:京东商品详情接口快速上手与JSON实战

技术入门:京东商品详情接口快速上手与JSON实战

原创
作者头像
Anzexi58
发布2026-07-29 17:39:15
发布2026-07-29 17:39:15
230
举报
文章被收录于专栏:API接口开发API接口开发

做电商相关开发时,京东商品详情接口是最常用的基础工具之一,它不用写复杂爬虫,就能稳定拿到商品的全维度结构化数据,新手也能快速对接落地,是电商数据开发里性价比很高的入门级接口。

一、接口核心能拿到什么数据

这个接口覆盖了电商业务需要的几乎所有核心商品信息,不用自己从页面零散抓取:

基础标识:商品SKU唯一ID、标题、品牌、所属类目、店铺名称、是否京东自营

价格优惠:日常售价、原价、店铺优惠券、券后最终到手价

分销相关:佣金比例、单商品预估佣金,适合CPS带货场景

销量库存:总销量、近30天销量、实时可售库存、商品上架状态

素材资源:商品主图、详情图数组,直接用于铺货、素材采集

SKU明细:不同颜色、尺码的子规格,对应单独的价格和库存数据

二、最简接入步骤

新手跟着3步就能完成基础调用,不用复杂配置:

注册京东开放平台开发者账号,创建应用后申请商品详情查询权限,拿到AppKey和AppSecret两个密钥

把请求参数按字典序排序,拼接后首尾加上AppSecret,用MD5加密转大写生成签名,完成鉴权

用HTTPS POST方式把请求发到官方API网关,就能拿到标准JSON格式的返回数据

三、可直接参考的成功返回JSON示例

这是脱敏后的标准返回结构,核心字段都标注了业务含义,直接复制就能用于开发测试:

代码语言:javascript
复制
{
  "jd_union_open_goods_detail_query_response": {
    "code": "0",
    "msg": "success",
    "requestId": "req_2026072917300012",
    "result": {
      "goodsInfo": {
        "skuId": "100065474274",
        "title": "夏季纯棉宽松短袖女 纯色百搭基础T恤多色可选",
        "brandName": "简禾",
        "categoryName": "女装 > T恤",
        "shopName": "简禾官方旗舰店",
        "isJdSelf": false,
        "itemUrl": "https://item.jd.com/100065474274.html",
        "priceInfo": {
          "originalPrice": "79.90",
          "discountPrice": "59.00"
        },
        "couponInfo": {
          "couponDiscount": "10.00",
          "finalPrice": "49.00",
          "couponDesc": "满59减10店铺优惠券"
        },
        "commissionInfo": {
          "commissionRate": "12.50",
          "commissionMoney": "6.13"
        },
        "salesInfo": {
          "totalSales": 9650,
          "monthSales": 2360
        },
        "stockInfo": {
          "totalStock": 460,
          "isSale": true
        },
        "imageInfo": {
          "mainImg": "https://img.jd.com/imgextra/i1/main.jpg",
          "detailImgList": [
            "https://img.jd.com/imgextra/i1/detail_01.jpg",
            "https://img.jd.com/imgextra/i1/detail_02.jpg"
          ]
        },
        "skuList": [
          {
            "skuId": "10006547427401",
            "specText": "白色 M",
            "skuPrice": "59.00",
            "skuStock": 180
          },
          {
            "skuId": "10006547427402",
            "specText": "黑色 XL",
            "skuPrice": "59.00",
            "skuStock": 125
          }
        ],
        "productParams": [
          {"name": "面料", "value": "100%纯棉"},
          {"name": "版型", "value": "宽松常规"},
          {"name": "适用季节", "value": "夏季"}
        ],
        "commentSummary": {
          "goodRateShow": "96.5",
          "commentCount": 1420
        }
      }
    }
  }
}

四、新手必看的高频问题处理

实际调用时遇到报错不用慌,几个常见问题都有明确解决方案:

code=15 签名校验错误:检查参数排序是否正确,AppSecret有没有写错

code=3005 商品不存在:确认传入的SKU ID是京东平台的有效商品ID

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

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

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

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

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档