技术实战：京东商品详情API技术解析与标准JSON返回参考
前言
京东开放平台（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店铺），发货和售后由商家负责。
