「代码实战」如何优雅地调用淘宝 API？封装一个可复用的商品信息获取类

pip install requests pycryptodome

import requests
import time
import hashlib
from urllib.parse import urlencode
from typing import Dict, Optional, Tuple


class TaobaoProductApi:
    """淘宝商品信息获取工具类，支持获取商品详情、价格等信息"""
    
    def __init__(self, app_key: str, app_secret: str):
        """
        初始化淘宝API配置
        :param app_key: 淘宝开放平台申请的App Key
        :param app_secret: 淘宝开放平台申请的App Secret
        """
        # 固定配置：接口基础地址、请求超时时间
        self.app_key = app_key
        self.app_secret = app_secret
        self.base_url = "https://eco.taobao.com/router/rest"  # 淘宝API公共网关
        self.timeout = 10  # 请求超时时间（秒）

    def _generate_sign(self, params: Dict) -> str:
        """
        生成淘宝API所需的签名（签名规则：参数按key排序→拼接→加secret→MD5加密→转大写）
        :param params: 待签名的请求参数
        :return: 签名字符串
        """
        # 1. 按参数key的ASCII码升序排序
        sorted_params = sorted(params.items(), key=lambda x: x[0])
        # 2. 拼接为"key=value&key=value"格式
        param_str = urlencode(sorted_params)
        # 3. 拼接App Secret，生成签名
        sign_str = self.app_secret + param_str + self.app_secret
        # 4. MD5加密并转为大写
        sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
        return sign

    def _create_common_params(self, method: str) -> Dict:
        """
        创建淘宝API的公共请求参数（所有接口均需携带）
        :param method: 接口名称（如"taobao.item.get"表示获取商品详情）
        :return: 公共参数字典
        """
        return {
            "app_key": self.app_key,
            "method": method,
            "format": "json",  # 返回格式
            "v": "2.0",  # API版本
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),  # 当前时间
            "sign_method": "md5"  # 签名方式
        }

    def get_product_detail(self, num_iid: str) -> Tuple[bool, Optional[Dict]]:
        """
        获取商品详情信息（调用taobao.item.get接口）
        :param num_iid: 商品ID（淘宝商品的唯一标识）
        :return: (是否成功, 数据/错误信息)：成功时返回(True, 商品详情字典)，失败时返回(False, 错误描述)
        """
        try:
            # 1. 检查必填参数
            if not num_iid.strip():
                return False, "商品ID(num_iid)不能为空"
            
            # 2. 构建请求参数（公共参数+接口私有参数）
            method = "taobao.item.get"
            common_params = self._create_common_params(method)
            private_params = {
                "num_iid": num_iid,
                "fields": "num_iid,title,price,pic_url,detail_url,stock"  # 需要返回的字段
            }
            all_params = {**common_params, **private_params}
            
            # 3. 生成签名并添加到参数中
            all_params["sign"] = self._generate_sign(all_params)
            
            # 4. 发送GET请求
            response = requests.get(
                url=self.base_url,
                params=all_params,
                timeout=self.timeout
            )
            response.raise_for_status()  # 若状态码非200，抛出HTTPError
            
            # 5. 解析返回结果
            result = response.json()
            # 淘宝API成功时返回"item_get_response"，失败时返回"error_response"
            if "error_response" in result:
                error_msg = result["error_response"]["msg"]
                return False, f"API返回错误：{error_msg}"
            product_data = result["item_get_response"]["item"]
            return True, product_data
        
        except requests.exceptions.RequestException as e:
            # 捕获网络异常（超时、连接失败等）
            return False, f"网络请求错误：{str(e)}"
        except Exception as e:
            # 捕获其他未知异常
            return False, f"未知错误：{str(e)}"


# ------------------- 类的使用示例 -------------------
if __name__ == "__main__":
    # 1. 替换为自己的App Key和App Secret
    APP_KEY = "你的淘宝App Key"
    APP_SECRET = "你的淘宝App Secret"
    
    # 2. 初始化API工具类
    taobao_api = TaobaoProductApi(app_key=APP_KEY, app_secret=APP_SECRET)
    
    # 3. 获取指定商品详情（示例商品ID：自行替换为真实有效ID）
    product_id = "612345678901"  # 注意：需使用有权限访问的商品ID
    success, data = taobao_api.get_product_detail(num_iid=product_id)
    
    # 4. 处理结果
    if success:
        print("商品详情获取成功：")
        print(f"商品标题：{data['title']}")
        print(f"商品价格：{data['price']}元")
        print(f"商品图片：{data['pic_url']}")
        print(f"商品库存：{data['stock']}件")
    else:
        print(f"商品详情获取失败：{data}")