淘宝商品详情API接口（稳定版json数据示例参考）

以下是关于淘宝商品详情API接口的详细说明及稳定版JSON数据示例参考：

一、商品详情API接口调用流程

1. 注册与认证
   • 注册开发者账号并完成实名认证。
   • 创建应用，获取App Key和App Secret（调用接口的身份凭证），需妥善保管。
2. 权限申请
   • 在应用管理页面申请taobao.item.get（商品详情接口）权限，部分高级接口需提交业务场景说明，审核通过后方可使用。
3. 构造请求
   • 请求地址：
   • 请求参数（以获取单个商品详情为例）：

     	params = {
     	"method": "taobao.item.get", # 接口名称
     	"app_key": "your_app_key", # 替换为你的App Key
     	"num_iid": "123456789", # 商品ID（必填）
     	"fields": "num_iid,title,price,pic_url,skus", # 指定返回字段
     	"timestamp": "2025-03-31 12:00:00", # 请求时间戳（需动态生成）
     	"format": "json", # 返回格式
     	"v": "2.0", # API版本
     	"sign_method": "md5", # 签名算法
     	"sign": "生成的签名" # 需按规则生成（见下文）
     	}

   • 签名生成规则：
     将参数按字典序排序后拼接，加上App Secret，进行MD5加密并转为大写。例如：

     	def generate_sign(params, app_secret):
     	sorted_params = sorted(params.items())
     	sign_str = "".join([f"{k}{v}" for k, v in sorted_params if k != "sign"])
     	sign_str += app_secret
     	return hashlib.md5(sign_str.encode()).hexdigest().upper()

4. 发送请求与接收响应
   • 使用HTTP库（如Python的requests）发送GET请求，接收JSON格式的响应数据。

二、稳定版JSON数据示例

	{
	"taobao_response": {
	"code": 200, // 返回码（200表示成功）
	"msg": "success", // 返回信息
	"request_id": "123e4567-e89b-12d3-a456-426614174001", // 唯一请求标识符
	"item_get_response": {
	"item": {
	"num_iid": "123456789", // 商品ID
	"title": "夏季新款男士短袖T恤圆领纯棉上衣", // 商品标题
	"price": "59.90", // 当前售价（单位：元）
	"original_price": "99.00", // 原价（如无促销则为空）
	"num": 100, // 库存数量（部分接口可能不返回）
	"detail_url": "https://item.taobao.com/item.htm?id=123456789", // 详情页链接
	"pic_url": [ // 商品主图URL列表
	"//img.alicdn.com/imgextra/i1/123456789/O1CN01abcd123456789_1.jpg",
	"//img.alicdn.com/imgextra/i1/123456789/O1CN01abcd123456789_2.jpg"
	],
	"desc": " 商品描述内容（可能包含HTML标签）... ", // 商品描述
	"props": [ // 商品属性列表
	{"name": "品牌", "value": "某品牌"},
	{"name": "颜色", "value": "白色"},
	{"name": "尺码", "value": "M/L/XL"}
	],
	"skus": { // SKU信息（不同规格的价格、库存等）
	"sku": [
	{
	"sku_id": "sku_1",
	"price": "59.90",
	"quantity": 50, // 库存
	"properties": "颜色:白色;尺码:M"
	},
	{
	"sku_id": "sku_2",
	"price": "59.90",
	"quantity": 30,
	"properties": "颜色:黑色;尺码:L"
	}
	]
	},
	"seller_info": { // 卖家信息
	"nick": "店铺名称", // 卖家昵称
	"shop_id": "987654321", // 店铺ID
	"shop_name": "某品牌旗舰店"
	},
	"coupon_info": { // 优惠券信息（如有）
	"amount": "10.00", // 优惠券金额
	"start_time": "2025-03-31 00:00:00", // 生效时间
	"end_time": "2025-04-30 23:59:59" // 失效时间
	},
	"promotions": [ // 促销活动（如有）
	{
	"type": "满减",
	"desc": "满100元减20元"
	}
	]
	}
	}
	}
	}

三、关键字段说明

字段名	类型	描述
num_iid	String	商品唯一ID
title	String	商品标题
price	String	当前售价（单位：元）
original_price	String	原价（如无促销则为空）
detail_url	String	商品详情页链接
pic_url	Array	商品主图URL列表
skus	Object	SKU信息（不同规格的价格、库存、属性等）
props	Array	商品属性列表（如品牌、颜色、尺码）
seller_info	Object	卖家信息（昵称、店铺ID、店铺名称）
coupon_info	Object	优惠券信息（金额、生效/失效时间）
promotions	Array	促销活动列表（类型、描述）

如有进一步需求（如批量获取商品详情、获取评论数据等），可参考开放平台的其他API接口