技术实战：京东开放平台商品详情API技术解析与标准JSON返回参考

原创

Anzexi58

发布于 2026-09-09 17:06:02

120

前言

京东开放平台（JOS, Jingdong Open Service）是京东生态体系的核心数据枢纽，为第三方开发者、ISV服务商及品牌商家提供标准化的API接口。其中，商品详情接口（如 jd.item.get 或 360buy_item_get）是电商ERP、比价系统、选品工具最基础且最高频调用的接口之一。该接口能够实时获取京东全站商品的标题、价格、库存、规格参数、图片资源及售后政策等全维度结构化数据。

一、接口核心基础信息

表格

项目	说明
接口名称
获取单品详细信息 (jd.item.get / 360buy_item_get)

请求协议	HTTPS POST / GET
数据格式	JSON (推荐) 或 XML
网关地址	o0b.cn/anzexi(正式环境)
鉴权方式	OAuth2.0 (Access Token) + 签名机制 (Sign)
适用场景	商品同步、价格监控、库存校验、详情页重构

二、核心请求参数解析

调用京东API必须遵循严格的签名算法（MD5或SHA256），所有公共参数和业务参数均需参与签名计算。

1. 公共必选参数

表格

参数名	类型	必填	描述
app_key	String	是	应用AppKey，在京东开放平台创建应用后获取
method	String	是	API接口名称，如jd.item.get
access_token	String	是	用户授权令牌，代表当前操作者的身份权限
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为东八区
v	String	是	API协议版本，通常为2.0
sign_method	String	是	签名算法，可选md5或sha256
sign	String	是	签名值，由AppSecret对参数排序拼接后加密生成
format	String	否	返回格式，默认为json

2. 业务请求参数

表格

参数名	类型	必填	描述
sku_id	Long	是	京东商品SKU ID（注意：不是SPU ID，需精确到具体规格）
fields	String	否	需要返回的字段集合，如skuId,title,price,imageUrl。不传则返回默认全集，建议按需指定以提升性能

三、标准JSON返回参考

以下是基于京东开放平台规范整理的标准成功响应结构。实际返回中，jd_item_get_response 节点内包含 item 对象，涵盖了商品的核心业务数据。

{
  "jd_item_get_response": {
    "code": "0",
    "msg": "success",
    "request_id": "10b3a8c7-9d2e-4f1a-b5c6-8e7d9f0a1b2c",
    "item": {
      "sku_id": 100012345678,
      "spu_id": 1000123456,
      "title": "Apple iPhone 15 Pro Max (A3108) 256GB 原色钛金属 支持移动联通电信5G 双卡双待手机",
      "sub_title": "A17 Pro芯片，钛金属设计，行动按钮",
      "brand_name": "Apple",
      "category_id": 9987,
      "category_name": "手机通讯 > 手机 > 智能手机",
      
      "price_info": {
        "jd_price": "9999.00",
        "market_price": "10999.00",
        "discount": "9.1",
        "currency": "CNY"
      },
      
      "stock_info": {
        "stock_state": 1,
        "stock_state_desc": "现货",
        "delivery_type": 1,
        "is_zy": true
      },
      
      "image_info": {
        "main_image": "https://img14.360buyimg.com/n1/s450x450_jfs/t00/123/456.jpg",
        "image_list": [
          "https://img14.360buyimg.com/n1/s450x450_jfs/t00/123/456_1.jpg",
          "https://img14.360buyimg.com/n1/s450x450_jfs/t00/123/456_2.jpg",
          "https://img14.360buyimg.com/n1/s450x450_jfs/t00/123/456_3.jpg"
        ]
      },
      
      "specifications": [
        {
          "key": "机身颜色",
          "value": "原色钛金属"
        },
        {
          "key": "内存容量",
          "value": "256GB"
        },
        {
          "key": "运行内存RAM",
          "value": "8GB"
        }
      ],
      
      "sales_info": {
        "comment_count": 560000,
        "good_rate": "98%",
        "video_show_count": 120
      },
      
      "service_info": {
        "self_run": true,
        "free_shipping": true,
        "support_cod": false,
        "invoice_provided": true,
        "warranty": "全国联保，享受三包服务，质保期为：1年"
      },
      
      "shop_info": {
        "shop_id": 1000000123,
        "shop_name": "Apple产品京东自营旗舰店",
        "shop_score": {
          "product_score": "9.8",
          "service_score": "9.7",
          "logistics_score": "9.9"
        }
      }
    }
  }
}

四、关键字段业务含义解析

SKU ID vs SPU ID：
sku_id 是库存量单位，对应具体颜色、内存组合的唯一商品，是交易和库存的最小粒度。
spu_id 是标准化产品单元，对应一款机型（如iPhone 15 Pro Max），一个SPU下包含多个SKU。
注意：查询详情时必须传入 sku_id，否则无法获取准确价格和库存。
价格体系 (price_info)：
jd_price：京东前台展示的实时售价，可能随促销活动动态变化。
market_price：厂商指导价或划线价，用于展示折扣力度。
提示：部分特殊商品（如秒杀、拼购）价格可能需要调用专门的促销接口获取。
库存状态 (stock_state)：
1：现货，可立即下单。
33：无货，但可预订。
34：无货，不可购买。
36：采购中。
提示：库存具有地域性，标准接口返回的是默认仓库或主站库存，若需精准地域库存，需配合 area_id 参数调用库存专用接口。
自营标识 (self_run)：
true 表示京东自营商品，由京东发货并提供售后，物流速度最快，信誉度最高。
false 表示第三方卖家（POP店铺），发货和售后由商家负责。

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

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

api-key

技术实战：京东开放平台商品详情API技术解析与标准JSON返回参考

技术实战：京东开放平台商品详情API技术解析与标准JSON返回参考

一、接口核心基础信息

二、核心请求参数解析

1. 公共必选参数

2. 业务请求参数

三、标准JSON返回参考

四、关键字段业务含义解析

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐