京东（JD）API 商品详情数据接口讲解及 JSON 示例

前言

京东开放平台提供了多种商品详情相关的 API 接口，开发者可以通过这些接口获取商品的详细信息。以下为接口调用方式及 JSON 返回数据的参考示例。

---

1. 接口调用方式

京东商品详情接口通常采用以下形式：

• 请求方式：GET/POST
• 关键参数：
  • method：接口方法名（如 jd.union.open.goods.query）。
  • app_key：应用的唯一标识。
  • access_token：访问令牌。
  • timestamp：请求时间戳。
  • sign：请求签名（用于安全验证）。
  • param_json：请求参数（JSON 格式，包含商品 ID 等）。

---

2. 商品详情 JSON 返回示例

以下是一个典型的商品详情 API 返回的 JSON 数据示例：

	{
	"jd_union_open_goods_query_responce": {
	"code": "0",
	"queryResult": {
	"skuId": "100126351037",
	"skuName": "京东鲜花爱丽丝泡泡鲜切花云南鲜花家庭插花爱丽丝泡泡10枝源头直发",
	"price": 30.90,
	"original_price": 49.00,
	"imageUrl": "http://m.360buyimg.com/mobilecms/s1080x1080_jfs/t1/237316/6/21934/216236/672351e2F577e6517/05e435e41704c438.jpg",
	"shopName": "京东鲜花自营专区",
	"couponInfo": "满50减10",
	"comments": 1200,
	"goodCommentsShare": "98%"
	}
	}
	}

3. 字段说明

• skuId：商品唯一标识符。
• skuName：商品名称。
• price：当前价格。
• original_price：原价。
• imageUrl：商品主图链接。
• shopName：店铺名称。
• couponInfo：优惠券信息。
• comments：总评价数。
• goodCommentsShare：好评率。

---

4. 扩展字段示例

部分接口可能返回更详细的商品信息，例如：

	{
	"item": {
	"num_iid": "123456789",
	"title": "Redmi K60 Pro 5G手机 骁龙8 Gen2 12GB+256GB",
	"price": {
	"current": 2999.00,
	"original": 3599.00,
	"discount": 16.7
	},
	"stock": {
	"quantity": 50,
	"status": "有货"
	},
	"images": [
	"https://img.jd.com/main.jpg",
	"https://img.jd.com/detail1.jpg"
	],
	"specs": [
	{
	"key": "屏幕尺寸",
	"value": "6.67英寸"
	},
	{
	"key": "处理器",
	"value": "骁龙8 Gen2"
	}
	],
	"reviews": {
	"total": 2000,
	"good_rate": 97.5,
	"sample": [
	"运行速度超快，屏幕显示细腻！",
	"拍照效果惊艳，性价比之选！"
	]
	},
	"service": {
	"return_policy": "支持7天无理由退货",
	"warranty": "1年官方保修"
	}
	},
	"msg": "调用成功"
	}

5. 扩展字段说明

• price：包含当前价格、原价及折扣比例。
• stock：库存数量及状态。
• images：商品图片列表。
• specs：商品规格参数。
• reviews：评价总数、好评率及示例评价。
• service：售后服务信息。

---