?

在電商系統開發、比價工具或優惠信息聚合平臺中，獲取商品的券后價格是一個常見且關鍵的需求。淘寶作為國內最大的電商平臺之一，提供了豐富的開放平臺API（Taobao Open Platform API）供開發者使用。本文將介紹如何合法、高效地通過淘寶API獲取商品的券后價信息。

一、 核心接口：taobao.tbk.item.coupon.get (淘寶客-商品-券)

淘寶客（Taobao Ke）是淘寶聯盟的推廣者體系。通過淘寶客相關的API，開發者可以獲取到商品的推廣信息，其中就包含優惠券數據。taobao.tbk.item.coupon.get 接口是專門用于查詢商品優惠券信息的核心接口。

接口主要功能

查詢指定商品的可用優惠券信息（面額、使用條件、有效期等）。

獲取商品的推廣鏈接（包含優惠券信息的淘口令或鏈接）。

請求關鍵參數說明

fields： 需要返回的字段列表。例如： num_iid, title, coupon_info, coupon_start_time, coupon_end_time, coupon_amount, coupon_start_fee 等。

pid： 推廣位ID（或稱為mm），需要事先在淘寶聯盟創建。

item_id： 淘寶的商品ID（即 num_iid）。這是商品的唯一標識。

platform： 鏈接適用的平臺（如 1 表示PC端， 2 表示無線端）。

返回數據結構解析

接口返回的JSON數據中，coupon_info 字段包含了優惠券的核心信息。其格式通常類似于： 滿199元減10元。 我們需要解析這個字符串來提取關鍵信息：

優惠券面額： 10元 （即 coupon_amount）。

使用門檻： 199元 （即 coupon_start_fee）。

計算券后價

獲取到商品的 原價 (通常通過 zk_final_price 或 reserve_price 字段獲得) 和 優惠券面額 (coupon_amount) 后，券后價格的計算公式非常簡單：

$$ text{券后價} = text{原價} - text{優惠券面額} $$

$$ text{券后價} = text{zk_final_price} - text{coupon_amount} $$

注意：需要判斷商品原價是否達到了優惠券的使用門檻 (coupon_start_fee)。如果原價低于門檻，則優惠券無法使用，券后價等于原價。

二、 接口調用流程與示例代碼

1. 準備工作

注冊成為淘寶聯盟開發者 (https://pub.alimama.com/)。

創建應用，獲取 App Key 和 App Secret。

在淘寶聯盟后臺創建推廣位 (pid / mm)。

2. 調用步驟

簽名生成： 使用 App Secret 對請求參數進行簽名 (sign)。淘寶API通常使用MD5簽名。

構造請求URL： 包含API地址、公共參數（如 app_key, sign, timestamp, v 等）、業務參數（如 fields, item_id, pid）。

發送HTTP請求： 使用GET或POST方式發送請求。

解析響應： 處理返回的JSON數據，提取 coupon_info 并解析，結合商品原價計算券后價。

3. Python 示例代碼片段

import requests
import hashlib
import time
import urllib.parse

def get_coupon_price(item_id, app_key, app_secret, pid):
    # 基礎API地址
    base_url = "https://eco.taobao.com/router/rest"
    
    # 公共參數
    params = {
        'method': 'taobao.tbk.item.coupon.get',
        'app_key': app_key,
        'timestamp': str(int(time.time())),  # 當前時間戳
        'format': 'json',
        'v': '2.0',
        'sign_method': 'md5',
        'fields': 'num_iid,title,zk_final_price,coupon_info,coupon_amount,coupon_start_fee',
        'item_id': item_id,
        'pid': pid,
        'platform': '2'  # 無線端
    }
    
    # 1. 參數排序并拼接
    sorted_params = sorted(params.items())
    query_string = urllib.parse.urlencode(sorted_params)
    
    # 2. 生成簽名字符串 (拼接app_secret)
    sign_str = app_secret + query_string + app_secret
    # 3. 計算MD5簽名
    sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
    params['sign'] = sign
    
    # 4. 發送請求
    response = requests.get(base_url, params=params)
    data = response.json()
    
    # 5. 處理響應
    if 'tbk_item_coupon_get_response' in data and 'results' in data['tbk_item_coupon_get_response']:
        item_data = data['tbk_item_coupon_get_response']['results']['n_tbk_item'][0]
        
        # 解析原價 (假設使用zk_final_price)
        original_price = float(item_data['zk_final_price'])
        # 解析優惠券信息 (簡化處理，實際需解析coupon_info字符串)
        coupon_amount = float(item_data['coupon_amount'])
        coupon_start_fee = float(item_data['coupon_start_fee'])
        
        # 計算券后價 (檢查是否滿足門檻)
        if original_price >= coupon_start_fee:
            coupon_price = original_price - coupon_amount
        else:
            coupon_price = original_price
        
        return {
            'item_id': item_id,
            'title': item_data['title'],
            'original_price': original_price,
            'coupon_amount': coupon_amount,
            'coupon_start_fee': coupon_start_fee,
            'coupon_price': coupon_price
        }
    else:
        # 處理錯誤
        error = data.get('error_response', {})
        return {
            'error': True,
            'code': error.get('code'),
            'msg': error.get('msg')
        }

# 示例調用 (請替換為你的真實App Key, Secret, PID 和商品ID)
result = get_coupon_price('1234567890', 'YOUR_APP_KEY', 'YOUR_APP_SECRET', 'mm_123456789_00000000')
print(result)

三、 注意事項與最佳實踐

認證與授權： 嚴格遵守淘寶聯盟的開發者協議和推廣規則。未授權調用可能導致接口限制或封禁。

請求頻率限制： 淘寶API有調用頻率限制（QPS），請根據應用場景合理設計調用策略，避免觸發限流。

錯誤處理： 完善代碼中的錯誤處理邏輯（如網絡錯誤、API返回錯誤碼 7 表示調用頻率過高，15 表示無權限等）。

數據緩存： 對于非實時性要求極高的場景，考慮對商品價格和優惠券信息進行適當緩存，減少API調用次數。

用戶代理： 在HTTP請求頭中設置合理的 User-Agent。

優惠券狀態： 注意優惠券的有效期 (coupon_start_time, coupon_end_time)，返回的優惠券可能已過期或未開始。

多重優惠： 復雜的營銷活動可能包含店鋪券、商品券、跨店滿減等疊加優惠。此接口主要返回單品券信息，更復雜的優惠計算需要結合其他接口或業務邏輯。

商品狀態： 檢查商品是否下架或不存在。

結語

通過淘寶開放平臺的 taobao.tbk.item.coupon.get 接口，開發者可以相對便捷地獲取商品的優惠券信息并計算出券后價格。關鍵在于正確使用API參數、處理簽名、解析返回數據并遵守平臺規則。希望本文能為你在開發相關功能時提供清晰的指引。如有任何疑問，歡迎大家留言探討。

?
審核編輯 黃宇