?

在電商開發中，獲取商品的券后價是常見需求，尤其對于比價工具或優惠監控應用。淘寶開放平臺提供了API接口，允許開發者通過程序化方式獲取商品詳情和券后價格。本技術貼將一步步指導您如何實現這一功能，包括API調用方法、代碼示例和注意事項。所有步驟基于淘寶官方文檔（需注冊開發者賬號），確保真實可靠。

1. API概述

淘寶的商品詳情API（如 taobao.item.get）可以返回商品基礎信息，包括原始價格、促銷活動等。券后價通常指商品在優惠券抵扣后的實際價格，計算公式為：
券后價 $= text{原始價格} - text{優惠券面額}$
在實際API調用中，券后價需從返回數據中解析優惠券信息后計算得出。淘寶API使用RESTful風格，數據格式為JSON，調用需HTTPS請求。

2. 調用步驟

以下是實現獲取券后價的完整流程，分為四個步驟：

注冊淘寶開放平臺賬號
訪問淘寶開放平臺，注冊開發者賬號并創建應用。獲取 app_key 和 app_secret（用于API簽名認證）。注意：應用需審核通過才能調用API。

準備API請求參數
核心API為 taobao.item.get，需指定商品ID（num_iid）和字段列表（fields）。關鍵參數包括：

num_iid：商品ID（如淘寶商品鏈接中的數字ID）。

fields：需返回的字段，例如 num_iid,title,price,coupon_info（coupon_info 包含優惠券數據）。

其他必填參數：method, app_key, timestamp, sign_method, v（API版本）。
完整參數參考官方文檔。

生成API簽名
淘寶API要求對參數進行簽名（Sign），使用MD5或HMAC算法。簽名公式為：
$$ text{sign} = text{md5}(text{app_secret} + text{sorted_params} + text{app_secret}) $$
其中 sorted_params 是參數按字母順序排序后的字符串。簽名確保請求安全。

發送請求并解析券后價
發送HTTP GET請求到淘寶API網關（https://router.taobao.com/router/rest）。從響應JSON中提取：

原始價格（price）。

優惠券信息（coupon_info），包含面額（denomination）。
券后價計算：若優惠券面額為 $d$，原始價格為 $p$，則券后價為 $p - d$。

3. 代碼示例（Python）

以下Python代碼展示如何調用API獲取商品券后價。使用 requests 庫發送請求，并解析JSON數據。注意：替換 YOUR_APP_KEY 和 YOUR_APP_SECRET 為您的實際憑據。

import requests
import hashlib
import time
import urllib.parse

def get_taobao_coupon_price(item_id):
    # 基礎參數設置
    app_key = "YOUR_APP_KEY"  # 替換為您的app_key
    app_secret = "YOUR_APP_SECRET"  # 替換為您的app_secret
    base_url = "https://router.taobao.com/router/rest"
    
    # 構建請求參數
    params = {
        "method": "taobao.item.get",
        "app_key": app_key,
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "num_iid": item_id,  # 商品ID
        "fields": "num_iid,title,price,coupon_info"  # 關鍵字段：價格和優惠券
    }
    
    # 生成簽名：參數排序 + MD5加密
    sorted_params = sorted(params.items())
    query_string = urllib.parse.urlencode(sorted_params)
    sign_str = app_secret + query_string + app_secret
    sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()
    params["sign"] = sign
    
    # 發送API請求
    response = requests.get(base_url, params=params)
    data = response.json()
    
    # 解析券后價
    if "item_get_response" in data and "item" in data["item_get_response"]:
        item_data = data["item_get_response"]["item"]
        original_price = float(item_data["price"])  # 原始價格
        coupon_info = item_data.get("coupon_info", {})
        denomination = float(coupon_info.get("denomination", 0))  # 優惠券面額，默認為0
        coupon_price = original_price - denomination  # 計算券后價
        return {
            "title": item_data["title"],
            "original_price": original_price,
            "coupon_price": coupon_price
        }
    else:
        raise Exception("API調用失敗: " + str(data.get("error_response", {}).get("msg", "未知錯誤")))

# 示例調用：獲取商品ID為"123456"的券后價
if __name__ == "__main__":
    item_id = "123456"  # 替換為實際商品ID
    result = get_taobao_coupon_price(item_id)
    print(f"商品標題: {result['title']}")
    print(f"原始價格: ￥{result['original_price']:.2f}")
    print(f"券后價格: ￥{result['coupon_price']:.2f}")

代碼說明：

使用 requests.get 發送請求，參數包括簽名和商品ID。

解析JSON響應，提取 price（原始價）和 coupon_info.denomination（優惠券面額）。

券后價通過減法計算：原始價 $-$ 面額。

錯誤處理：捕獲API返回的錯誤消息。

4. 注意事項

API限制：淘寶API有調用頻率限制（免費版約100次/天），超出需購買套餐。確保遵守平臺規則，避免封號。

數據準確性：券后價依賴優惠券信息（coupon_info），部分商品可能無優惠券，返回面額為0。建議結合 taobao.tbk.coupon.get API驗證優惠券狀態。

安全與授權：所有請求需HTTPS，app_secret 必須保密。用戶數據需隱私合規（如GDPR）。

測試建議：先在淘寶開放平臺沙箱環境測試，使用真實商品ID（如從淘寶商品URL獲取）。

性能優化：批量請求時，使用異步IO（如Python的 aiohttp）提升效率。

5. 總結

通過淘寶的 taobao.item.get API，開發者可以高效獲取商品券后價。核心步驟包括注冊賬號、構建簽名請求、解析響應數據。本示例提供了Python實現，您可擴展為自動化監控系統。實際應用中，建議監控API變更（淘寶會更新字段），并添加緩存機制減少調用次數。淘寶API文檔全面，遇到問題可參考官方社區。如果您有特定商品ID測試需求，歡迎進一步討論！

?
審核編輯 黃宇