从原理到实现：淘宝商品详情 API 的数据结构与调用机制剖析

{
    "item_get_response": {
        "result": {
            "num_iid": "698877665544",  // 商品ID
            "title": "2026新款夏季纯棉短袖T恤男女宽松百搭上衣",  // 商品标题
            "price": "59.90",  // 商品一口价（元）
            "promotion_price": "49.90",  // 商品促销价（元）
            "stock": 1256,  // 商品总库存
            "sales": 38900,  // 累计销量
            "pic_url": "https://img.alicdn.com/imgextra/i1/2688/TB3XXXXXXXL.jpg",  // 商品主图
            "detail_url": "https://item.taobao.com/item.htm?id=698877665544",  // 商品详情页URL
            "desc": "<p>纯棉面料...</p>",  // 商品详情描述（HTML格式）
            "brand": "XX服饰",  // 商品品牌
            // SKU规格数据（多规格商品核心）
            "sku_list": [
                {
                    "sku_id": "123456",
                    "color": "白色",
                    "size": "M",
                    "sku_price": "49.90",
                    "sku_stock": 320
                },
                {
                    "sku_id": "123457",
                    "color": "黑色",
                    "size": "XL",
                    "sku_price": "59.90",
                    "sku_stock": 280
                }
            ],
            // 店铺信息
            "shop_info": {
                "shop_id": "987654321",
                "shop_name": "XX服饰旗舰店",
                "shop_type": "tmall",  // 店铺类型：taobao(淘宝)/tmall(天猫)
                "score": 4.8  // 店铺评分
            }
        },
        "success": true,  // 请求是否成功
        "error_code": 0,  // 错误码（0为成功）
        "error_msg": ""  // 错误信息（成功时为空）
    }
}

import requests
import hashlib
import time
from urllib.parse import urlencode, quote_plus

# ===================== 配置项（替换为自己的信息）=====================
APP_KEY = "你的AppKey"          # 淘宝开放平台应用AppKey
APP_SECRET = "你的AppSecret"    # 淘宝开放平台应用AppSecret
ITEM_ID = "698877665544"        # 要查询的淘宝商品ID
API_GATEWAY = "https://eco.taobao.com/router/rest"  # 淘宝API网关地址

def generate_sign(params, app_secret):
    """
    生成淘宝API签名（核心方法）
    :param params: 待签名的参数字典
    :param app_secret: 应用AppSecret
    :return: 32位大写MD5签名值
    """
    # 1. 按参数名ASCII码升序排序
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    # 2. 拼接成 key1value1key2value2 格式
    sign_str = ""
    for key, value in sorted_params:
        sign_str += f"{key}{value}"
    # 3. 首尾拼接AppSecret，执行MD5加密并转大写
    sign_str = app_secret + sign_str + app_secret
    md5 = hashlib.md5()
    md5.update(sign_str.encode("utf-8"))
    sign = md5.hexdigest().upper()
    return sign

def taobao_item_detail_get(item_id):
    """
    调用淘宝商品详情API，获取商品数据
    :param item_id: 淘宝商品ID
    :return: 解析后的商品字典数据
    """
    # 1. 构造基础请求参数
    params = {
        "method": "taobao.item.get",
        "app_key": APP_KEY,
        "v": "2.0",
        "format": "json",
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
        "item_num_iid": item_id,
        # 指定返回字段，按需增减，提升性能
        "fields": "num_iid,title,price,promotion_price,stock,sales,pic_url,detail_url,brand,shop_info"
    }
    
    # 2. 生成签名并追加到参数中
    params["sign"] = generate_sign(params, APP_SECRET)
    
    try:
        # 3. 发送GET请求调用API
        response = requests.get(API_GATEWAY, params=params, timeout=10)
        response.raise_for_status()  # 抛出HTTP请求异常
        result = response.json()
        
        # 4. 解析响应数据
        if result.get("item_get_response", {}).get("success"):
            return result["item_get_response"]["result"]
        else:
            error_msg = result.get("item_get_response", {}).get("error_msg", "接口调用失败")
            raise Exception(f"API响应错误：{error_msg}")
    
    except requests.exceptions.RequestException as e:
        raise Exception(f"网络请求异常：{str(e)}")
    except Exception as e:
        raise Exception(f"接口调用异常：{str(e)}")

# ===================== 主程序调用 =====================
if __name__ == "__main__":
    try:
        # 调用API获取商品详情
        item_data = taobao_item_detail_get(ITEM_ID)
        print("✅ 淘宝商品详情数据获取成功：")
        print(f"商品ID：{item_data['num_iid']}")
        print(f"商品标题：{item_data['title']}")
        print(f"商品价格：{item_data['price']} 元")
        print(f"促销价格：{item_data['promotion_price']} 元")
        print(f"商品库存：{item_data['stock']} 件")
        print(f"累计销量：{item_data['sales']} 件")
        print(f"店铺名称：{item_data['shop_info']['shop_name']}")
        print(f"店铺类型：{item_data['shop_info']['shop_type']}")
    
    except Exception as e:
        print(f"❌ 商品详情获取失败：{str(e)}")