京东商品详情 API jd.item.get 完整技术说明文档
文档概述
接口名称：jd.item_get（京东商品详情API）
接口用途：根据商品 SKU ID/Item ID 查询自营 / 第三方店铺完整商品元数据，支撑 ERP 同步、商品中台、竞品监控、店铺铺货、数据大屏等企业级场景
调用网关： c0b.cc/R4rbK2
传输协议：HTTPS POST/GET
数据格式：JSON（默认）、XML可选
接口版本：v2.0
一、接口基础信息
1.1 公共请求参数（所有调用必传）
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| app_key | String | 是 | 应用密钥，开放平台创建应用获取 |
| method | String | 是 | 固定值：jd.item.get |
| timestamp | String | 是 | 北京时间 yyyy-MM-dd HH:mm:ss，签名校验防重放 |
| v | String | 是 | 接口版本，固定 2.0 |
| format | String | 否 | 返回格式：json/xml，默认 json |
| sign | String | 是 | MD5 大写签名，签名规则：app_secret + 所有参数按key升序拼接 + app_secret 后 MD5 |
| access_token | String | 店铺授权场景必填 | OAuth 店铺授权令牌，服务商托管店铺必须携带 |
1.2 业务入参（核心查询参数）
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| skuId | Long | 二选一必填 | 100012345678 | 单品 SKU 编号（精准单规格查询，推荐） |
| itemId | Long | 二选一必填 | 1001234567 | 商品主商品 ID（多 SKU 套装商品入口 ID） |
| fields | String | 可选 | skuId,title,price,stock,skuList,image,param | 字段过滤，逗号分隔，不传返回全量字段，减少返回体积 |
1.3 标准请求示例（URL 拼接参数）
http
代码语言：javascript
POST https://api.jd.com/routerjson
Content-Type: application/x-www-form-urlencoded
app_key=YOUR_APP_KEY
&method=jd.item.get
×tamp=2026-06-17 16:30:00
