淘宝商品 API 接口架构解析：从请求到详情数据返回的完整链路

# 安装依赖库
pip install requests

import requests
import time
import hashlib
import json

class TaobaoItemAPI:
    def __init__(self, app_key, app_secret):
        """
        初始化淘宝API客户端
        :param app_key: 开放平台应用AppKey
        :param app_secret: 开放平台应用AppSecret
        """
        self.app_key = app_key
        self.app_secret = app_secret
        self.gateway_url = "https://eco.taobao.com/router/rest"  # 淘宝开放平台网关地址

    def generate_sign(self, params):
        """
        生成淘宝API签名
        :param params: 待签名的参数字典
        :return: 签名字符串
        """
        # 1. 按参数名ASCII升序排序
        sorted_params = sorted(params.items(), key=lambda x: x[0])
        # 2. 拼接参数字符串
        sign_str = ""
        for key, value in sorted_params:
            if value:  # 跳过空值参数
                sign_str += f"{key}{value}"
        # 3. 首尾拼接AppSecret并MD5加密
        sign_str = self.app_secret + sign_str + self.app_secret
        sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
        return sign

    def get_item_detail(self, num_iid, fields=None):
        """
        调用淘宝商品详情API（taobao.item.get）
        :param num_iid: 商品ID（必填）
        :param fields: 需要返回的字段列表，如["title", "price", "stock"]
        :return: 商品详情字典
        """
        # 默认返回核心字段
        if not fields:
            fields = [
                "num_iid", "title", "price", "stock", "sales", "item_imgs",
                "seller_nick", "cat_name", "desc_short"
            ]
        fields_str = ",".join(fields)

        # 1. 构建请求参数
        params = {
            "method": "taobao.item.get",  # API名称
            "app_key": self.app_key,
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),  # 时间戳
            "format": "json",  # 返回格式
            "v": "2.0",  # API版本
            "sign_method": "md5",  # 签名方式
            "num_iid": num_iid,  # 商品ID
            "fields": fields_str  # 返回字段
        }

        # 2. 生成签名并添加到参数中
        params["sign"] = self.generate_sign(params)

        try:
            # 3. 发送HTTP请求
            response = requests.get(self.gateway_url, params=params, timeout=10)
            response.raise_for_status()  # 抛出HTTP异常（如404/500）
            result = response.json()

            # 4. 解析响应
            if "error_response" in result:
                # 接口调用失败
                error = result["error_response"]
                raise Exception(f"API调用失败：{error['msg']}（错误码：{error['code']}）")
            else:
                # 接口调用成功，返回商品详情
                return result["item_get_response"]["item"]

        except requests.exceptions.RequestException as e:
            raise Exception(f"网络请求异常：{str(e)}")
        except Exception as e:
            raise Exception(f"解析响应异常：{str(e)}")

# ------------------- 示例调用 -------------------
if __name__ == "__main__":
    # 替换为你的AppKey和AppSecret（需从淘宝开放平台获取）
    APP_KEY = "your_app_key"
    APP_SECRET = "your_app_secret"
    # 测试商品ID（可替换为真实有效ID）
    TEST_ITEM_ID = "1234567890"

    # 初始化API客户端
    taobao_api = TaobaoItemAPI(APP_KEY, APP_SECRET)

    try:
        # 调用商品详情接口
        item_detail = taobao_api.get_item_detail(TEST_ITEM_ID)
        # 打印商品核心信息
        print("商品详情数据：")
        print(json.dumps(item_detail, ensure_ascii=False, indent=2))
    except Exception as e:
        print(f"调用失败：{str(e)}")