一、前言
京东开放平台的 JD.item_get 接口全流程解析，包含核心参数、标准返回结构、开发落地要点、常见错误处理，可直接用于数据采集、解析与入库。
二、接口概述
1. 核心接口信息
项⽬说明
接口名称商品详情查询（JD.item_get）
请求方式GET/POST（推荐 POST，避免参数暴露）
接口地址正式环境：http://o0b.cn/ibrad (前往体验接口测试， TaoxiJd-api 添加V获取）。
响应格式JSON
三、核心请求参数（必填 + 可选）
1. 必传参数
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| app_key | String | 京东开放平台分配的应用 ID | 23456789abcdef |
| method | String | 固定接口名，值为 jingdong.item.read.get | jingdong.item.read.get |
| item_id | String | 商品 SKU ID（从商品 URL 提取，如 http://item.jd.com/100012345678.html 中的 100012345678） | 100012345678 |
| timestamp | String | 时间戳，格式为 yyyy-MM-dd HH:mm:ss（需与服务器时间一致，避免签名失效） | 2026-04-16 15:20:00 |
| v | String | 接口版本号，固定值 2.0 | 2.0 |
| sign | String | 签名（按规则生成，防止参数篡改） | 3F2A1B...（MD5 加密后字符串） |
四. 可选参数（优化请求）
参数名类型说明
app_keyString京东开放平台分配的应用 ID（创建应用后获取）
methodString接口方法名，固定值：jingdong.item.get
access_tokenString用户授权令牌（无需用户授权的场景可传空，需提前配置应用权限）
item_idString京东商品 ID（商品详情页 URL 中http://item.jd.com/xxxx.html的xxxx部分）
timestampString时间戳（格式：yyyy-MM-dd HH:mm:ss，如 2026-01-14 10:00:00）
vString接口版本号，固定值：2.0
signString接口签名（根据 appsecret + 参数拼接加密生成，京东有固定签名规则）
五. 接口核心信息
| 项目 | 详情 |
|---|---|
| 接口名称 | JD.item_get（官方标准名：jingdong.item.read.get） |
| 核心功能 | 通过商品 SKU ID 获取京东商品全量详情（价格、库存、SKU 规格、图片、销量、店铺信息等） |
| 请求方式 | 推荐 POST（避免参数暴露），支持 GET |
| 响应格式 | JSON |
| 数据时效 | 分钟级更新，与京东主站同步 |
| 适用场景 | 电商比价、商品监控、选品分析、代购数据采集 |
总结
调用京东商品详情 API 的核心是获取有效的app_key/app_secret，并按规则生成sign签名；
Python 请求示例中，签名生成、参数构造、异常处理是保证接口调用成功的关键；
使用 API 时需遵守平台规范，优先做缓存优化，避免接口封禁或调用成本过高。
