自動生成簽名的接口模板 —— 即給定 AppKey 和 AppSecret，自動構造好簽名參數、拼裝請求、發送 API 請求的標準化封裝。

企業級可直接使用的 Python SDK 模板，

它能自動完成簽名、拼接參數、發請求和返回結果。

你只要改兩個值：APP_KEY 和 APP_SECRET。

一、模板說明

功能：

• 自動計算淘寶 TOP API 簽名；
• 支持所有淘寶開放平臺接口；
• 通用調用方法（不局限于商品詳情）；
• 自動 JSON 格式化結果；
• 兼容 Python 3.8+。

二、完整代碼（taobao_sdk.py）

import hashlib
import time
import requests
import json


class TaobaoSDK:
    """
    淘寶開放平臺通用SDK封裝
    支持所有API自動簽名調用
    """

    def __init__(self, app_key: str, app_secret: str, session: str = None):
        """
        初始化SDK
        :param app_key: 淘寶開放平臺 AppKey
        :param app_secret: 淘寶開放平臺 AppSecret
        :param session: 授權用戶會話key（有的API需要）
        """
        self.app_key = app_key
        self.app_secret = app_secret
        self.session = session
        self.gateway_url = "https://eco.taobao.com/router/rest"

    def _sign(self, params: dict) -> str:
        """
        生成 TOP API 簽名（MD5）
        """
        sorted_params = sorted(params.items())
        query_str = self.app_secret + ''.join(f"{k}{v}" for k, v in sorted_params) + self.app_secret
        return hashlib.md5(query_str.encode('utf-8')).hexdigest().upper()

    def call_api(self, method: str, **kwargs):
        """
        調用任意淘寶API接口
        :param method: API方法名（如 'taobao.tbk.item.info.get'）
        :param kwargs: 業務參數（如 num_iids='123456'）
        """
        params = {
            "method": method,
            "app_key": self.app_key,
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "format": "json",
            "v": "2.0",
            "sign_method": "md5",
        }

        # 添加業務參數
        params.update(kwargs)

        # 有session的接口自動加上
        if self.session:
            params["session"] = self.session

        # 簽名
        params["sign"] = self._sign(params)

        # 發送請求
        resp = requests.get(self.gateway_url, params=params, timeout=10)
        try:
            return resp.json()
        except json.JSONDecodeError:
            return {"error": "Invalid JSON response", "text": resp.text}


# ==========================
# ? 示例用法
# ==========================
if __name__ == "__main__":
    APP_KEY = "你的AppKey"
    APP_SECRET = "你的AppSecret"

    # 初始化SDK
    tao = TaobaoSDK(APP_KEY, APP_SECRET)

    # 示例1：獲取商品詳情
    result = tao.call_api(
        method="taobao.tbk.item.info.get",
        num_iids="1234567890123"
    )
    print("商品詳情：")
    print(json.dumps(result, indent=2, ensure_ascii=False))

    # 示例2：商品搜索
    search_result = tao.call_api(
        method="taobao.tbk.item.get",
        q="藍牙耳機",
        page_no=1,
        page_size=5
    )
    print("\n商品搜索結果：")
    print(json.dumps(search_result, indent=2, ensure_ascii=False))

?? 三、模板特性

四、調用方式舉例

from taobao_sdk import TaobaoSDK

tao = TaobaoSDK(app_key="xxxx", app_secret="xxxx")

# 獲取商品詳情
info = tao.call_api("taobao.tbk.item.info.get", num_iids="1234567890123")
print(info)

# 搜索商品
search = tao.call_api("taobao.tbk.item.get", q="華為手機", page_no=1)
print(search)

五、提示與進階用法

是否希望我幫你把上面這個 SDK 進一步打包成一個可 pip install 的項目結構？

（比如 taobao_sdk/ 包、setup.py、__init__.py、examples/ 等，方便直接集成進系統）