好的 ??

以下是一個完整、可直接運行的 淘寶商品詳情 Python SDK 示例（含簽名函數），

完全符合淘寶開放平臺官方接口規范。

?? 一、功能說明

本示例演示如何通過 淘寶開放平臺 API 調用
taobao.tbk.item.info.get 接口，獲取商品詳情。

?? 二、示例代碼

import requests
import hashlib
import time
import json

# ======【1】請在這里填寫你自己的AppKey與AppSecret ======
APP_KEY = "你的AppKey"
APP_SECRET = "你的AppSecret"

# ======【2】TOP API簽名算法 ======
def sign_taobao(params: dict) -> str:
    """
    按照淘寶TOP規范生成簽名
    """
    # 1. 對所有參數按字母排序
    sorted_params = sorted(params.items())
    # 2. 拼接成 keyvalue 字符串
    query_str = APP_SECRET + ''.join(f"{k}{v}" for k, v in sorted_params) + APP_SECRET
    # 3. MD5加密并轉大寫
    sign = hashlib.md5(query_str.encode('utf-8')).hexdigest().upper()
    return sign

# ======【3】發起淘寶API請求 ======
def get_taobao_item_info(num_iid: str):
    """
    調用淘寶客接口獲取商品詳情
    """
    url = "https://eco.taobao.com/router/rest"

    # 公共參數
    params = {
        "method": "taobao.tbk.item.info.get",
        "app_key": APP_KEY,
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "num_iids": num_iid,  # 商品ID，可傳多個逗號分隔
    }

    # 生成簽名
    params["sign"] = sign_taobao(params)

    # 發起請求
    resp = requests.get(url, params=params)
    data = resp.json()

    # 返回結果
    return data


# ======【4】示例調用 ======
if __name__ == "__main__":
    # 示例商品ID（替換成實際的）
    num_iid = "1234567890123"

    print("正在獲取淘寶商品詳情，請稍候...\n")
    result = get_taobao_item_info(num_iid)

    # 美化輸出
    print(json.dumps(result, indent=2, ensure_ascii=False))

三、返回結果示例

{
  "tbk_item_info_get_response": {
    "results": {
      "n_tbk_item": [
        {
          "num_iid": 1234567890123,
          "title": "Apple iPhone 15 Pro Max 手機",
          "pict_url": "https://img.alicdn.com/imgextra/i1/xxx.jpg",
          "small_images": {
            "string": [
              "https://img.alicdn.com/imgextra/i1/xxx.jpg",
              "https://img.alicdn.com/imgextra/i2/xxx.jpg"
            ]
          },
          "reserve_price": "9999.00",
          "zk_final_price": "8999.00",
          "item_url": "https://item.taobao.com/item.htm?id=1234567890123"
        }
      ]
    }
  }
}

?? 四、使用前準備

1. 前往 淘寶開放平臺 注冊并創建應用；
2. 獲取 AppKey 和 AppSecret；
3. 若使用淘寶客類API（tbk），需開通淘寶聯盟賬號。

?? 可擴展接口示例

你還可以替換 method 調用其它接口：

是否希望我幫你把這個示例擴展成一個 可復用的類 SDK（帶商品詳情、搜索、優惠券）？

那樣你可以像下面這樣用??：

tao = TaobaoSDK(APP_KEY, APP_SECRET)
info = tao.get_item_info("1234567890123")
search = tao.search_items("藍牙耳機")