京东商品详情API接口概述（属性规格详情图价格等json数据返回参考）

京东商品详情API接口概述

京东商品详情API接口是京东开放平台为开发者提供的核心服务，用于获取商品的详细信息，包括属性、规格、详情图、价格等。开发者可通过该接口实现商品展示、价格监控、数据分析等功能。以下是接口的详细说明及JSON数据返回示例。

---

一、接口功能

1. 商品基本信息
   • 商品ID、名称、品牌、分类、产地等。
2. 价格信息
   • 当前价格、原价等。
3. 库存信息
   • 库存数量、库存状态（有货/无货）、预售信息等。
4. 规格参数
   • 商品的规格属性（如颜色、尺寸、内存等）。
5. 商品详情图
   • 主图、详情图、视频链接等。
6. 用户评价
   • 评价总数、好评率、差评关键词等（部分接口需单独申请权限）。

---

二、接口调用方式

1. 请求方式
   • 支持GET或POST请求。
2. 请求参数
   • app_key：应用的唯一标识。
   • method：接口方法名（如jd.union.open.goods.detail.query）。
   • timestamp：请求时间戳。
   • sign：请求签名（用于安全验证）。
   • param_json：请求参数（JSON格式，包含商品ID等）。
3. 返回格式
   • 通常为JSON格式。

---

三、JSON数据返回示例

1. 商品基础信息

	{
	"code": 200,
	"message": "success",
	"data": {
	"goods_response": {
	"sku_id": "100012345678",
	"name": "华为Mate 50 Pro 5G手机",
	"price": 5999.00,
	"original_price": 6999.00,
	"image_path": "https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcdef.jpg",
	"stock_state": 1,
	"is_pre_sale": false,
	"is_appoint": false
	}
	}
	}

2. 商品详细信息

	{
	"code": 200,
	"message": "success",
	"data": {
	"goods_detail_response": {
	"sku_id": "100012345678",
	"name": "华为Mate 50 Pro 5G手机",
	"price": 5999.00,
	"description": " 华为Mate 50 Pro 5G手机，采用6.74英寸OLED屏幕... ",
	"after_service": "全国联保，享受三包服务",
	"spec_info": {
	"颜色": ["曜金黑", "冰霜银", "流光紫"],
	"内存": ["8GB+128GB", "8GB+256GB", "12GB+512GB"]
	},
	"property_info": [
	{"name": "品牌", "value": "华为"},
	{"name": "型号", "value": "Mate 50 Pro"},
	{"name": "操作系统", "value": "HarmonyOS 3.0"}
	],
	"image_list": [
	"https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcdef.jpg",
	"https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcde1.jpg"
	],
	"evaluation": {
	"total_reviews": 1000,
	"positive_rate": "95%"
	}
	}
	}
	}

3. 商品SKU信息

	{
	"code": 200,
	"message": "success",
	"data": {
	"goods_skus_response": {
	"sku_id": "100012345678",
	"sku_list": [
	{
	"sku_id": "100012345678",
	"name": "华为Mate 50 Pro 5G手机 曜金黑 8GB+128GB",
	"price": 5999.00,
	"image_path": "https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcdef.jpg",
	"stock_state": 1,
	"spec": {
	"颜色": "曜金黑",
	"内存": "8GB+128GB"
	}
	},
	{
	"sku_id": "100012345679",
	"name": "华为Mate 50 Pro 5G手机 冰霜银 8GB+256GB",
	"price": 6499.00,
	"image_path": "https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcde2.jpg",
	"stock_state": 0,
	"spec": {
	"颜色": "冰霜银",
	"内存": "8GB+256GB"
	}
	}
	]
	}
	}
	}

---

四、关键字段说明

1. 商品基础信息
   • sku_id：商品唯一标识符。
   • name：商品名称。
   • price：当前价格（字符串类型，保留两位小数）。
   • original_price：原价。
   • image_path：商品主图URL。
   • stock_state：库存状态（1-有货，0-无货）。
   • is_pre_sale：是否为预售商品。
   • is_appoint：是否为预约商品。
2. 商品详细信息
   • description：商品详细描述（可能包含HTML标签）。
   • after_service：售后服务政策。
   • spec_info：商品规格信息（颜色、尺寸等）。
   • property_info：商品属性列表。
   • image_list：商品图片列表。
   • evaluation：用户评价信息（评价总数、好评率等）。
3. 商品SKU信息
   • sku_list：SKU列表。
   • spec：SKU规格属性。

---

通过京东商品详情API接口，开发者可以方便地获取到京东商品的详细信息，实现更好的产品展示和销售，为用户提供更加便捷和个性化的购物体验。