前言
京东开放平台（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店铺），发货和售后由商家负责。
