?

在電商系統(tǒng)開發(fā)、比價(jià)工具或優(yōu)惠信息聚合平臺(tái)中，獲取商品的券后價(jià)格是一個(gè)常見且關(guān)鍵的需求。淘寶作為國(guó)內(nèi)最大的電商平臺(tái)之一，提供了豐富的開放平臺(tái)API（Taobao Open Platform API）供開發(fā)者使用。本文將介紹如何合法、高效地通過(guò)淘寶API獲取商品的券后價(jià)信息。

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

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

接口主要功能

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

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

請(qǐng)求關(guān)鍵參數(shù)說(shuō)明

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

pid： 推廣位ID（或稱為mm），需要事先在淘寶聯(lián)盟創(chuàng)建。

item_id： 淘寶的商品ID（即 num_iid）。這是商品的唯一標(biāo)識(shí)。

platform： 鏈接適用的平臺(tái)（如 1 表示PC端， 2 表示無(wú)線端）。

返回?cái)?shù)據(jù)結(jié)構(gòu)解析

接口返回的JSON數(shù)據(jù)中，coupon_info 字段包含了優(yōu)惠券的核心信息。其格式通常類似于： 滿199元減10元。 我們需要解析這個(gè)字符串來(lái)提取關(guān)鍵信息：

優(yōu)惠券面額： 10元 （即 coupon_amount）。

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

計(jì)算券后價(jià)

獲取到商品的 原價(jià) (通常通過(guò) zk_final_price 或 reserve_price 字段獲得) 和 優(yōu)惠券面額 (coupon_amount) 后，券后價(jià)格的計(jì)算公式非常簡(jiǎn)單：

$$ text{券后價(jià)} = text{原價(jià)} - text{優(yōu)惠券面額} $$

$$ text{券后價(jià)} = text{zk_final_price} - text{coupon_amount} $$

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

二、 接口調(diào)用流程與示例代碼

1. 準(zhǔn)備工作

注冊(cè)成為淘寶聯(lián)盟開發(fā)者 (https://pub.alimama.com/)。

創(chuàng)建應(yīng)用，獲取 App Key 和 App Secret。

在淘寶聯(lián)盟后臺(tái)創(chuàng)建推廣位 (pid / mm)。

2. 調(diào)用步驟

簽名生成： 使用 App Secret 對(duì)請(qǐng)求參數(shù)進(jìn)行簽名 (sign)。淘寶API通常使用MD5簽名。

構(gòu)造請(qǐng)求URL： 包含API地址、公共參數(shù)（如 app_key, sign, timestamp, v 等）、業(yè)務(wù)參數(shù)（如 fields, item_id, pid）。

發(fā)送HTTP請(qǐng)求： 使用GET或POST方式發(fā)送請(qǐng)求。

解析響應(yīng)： 處理返回的JSON數(shù)據(jù)，提取 coupon_info 并解析，結(jié)合商品原價(jià)計(jì)算券后價(jià)。

3. Python 示例代碼片段

import requests
import hashlib
import time
import urllib.parse

def get_coupon_price(item_id, app_key, app_secret, pid):
    # 基礎(chǔ)API地址
    base_url = "https://eco.taobao.com/router/rest"
    
    # 公共參數(shù)
    params = {
        'method': 'taobao.tbk.item.coupon.get',
        'app_key': app_key,
        'timestamp': str(int(time.time())),  # 當(dāng)前時(shí)間戳
        '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'  # 無(wú)線端
    }
    
    # 1. 參數(shù)排序并拼接
    sorted_params = sorted(params.items())
    query_string = urllib.parse.urlencode(sorted_params)
    
    # 2. 生成簽名字符串 (拼接app_secret)
    sign_str = app_secret + query_string + app_secret
    # 3. 計(jì)算MD5簽名
    sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
    params['sign'] = sign
    
    # 4. 發(fā)送請(qǐng)求
    response = requests.get(base_url, params=params)
    data = response.json()
    
    # 5. 處理響應(yīng)
    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]
        
        # 解析原價(jià) (假設(shè)使用zk_final_price)
        original_price = float(item_data['zk_final_price'])
        # 解析優(yōu)惠券信息 (簡(jiǎn)化處理，實(shí)際需解析coupon_info字符串)
        coupon_amount = float(item_data['coupon_amount'])
        coupon_start_fee = float(item_data['coupon_start_fee'])
        
        # 計(jì)算券后價(jià) (檢查是否滿足門檻)
        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:
        # 處理錯(cuò)誤
        error = data.get('error_response', {})
        return {
            'error': True,
            'code': error.get('code'),
            'msg': error.get('msg')
        }

# 示例調(diào)用 (請(qǐng)?zhí)鎿Q為你的真實(shí)App Key, Secret, PID 和商品ID)
result = get_coupon_price('1234567890', 'YOUR_APP_KEY', 'YOUR_APP_SECRET', 'mm_123456789_00000000')
print(result)

三、 注意事項(xiàng)與最佳實(shí)踐

認(rèn)證與授權(quán)： 嚴(yán)格遵守淘寶聯(lián)盟的開發(fā)者協(xié)議和推廣規(guī)則。未授權(quán)調(diào)用可能導(dǎo)致接口限制或封禁。

請(qǐng)求頻率限制： 淘寶API有調(diào)用頻率限制（QPS），請(qǐng)根據(jù)應(yīng)用場(chǎng)景合理設(shè)計(jì)調(diào)用策略，避免觸發(fā)限流。

錯(cuò)誤處理： 完善代碼中的錯(cuò)誤處理邏輯（如網(wǎng)絡(luò)錯(cuò)誤、API返回錯(cuò)誤碼 7 表示調(diào)用頻率過(guò)高，15 表示無(wú)權(quán)限等）。

數(shù)據(jù)緩存： 對(duì)于非實(shí)時(shí)性要求極高的場(chǎng)景，考慮對(duì)商品價(jià)格和優(yōu)惠券信息進(jìn)行適當(dāng)緩存，減少API調(diào)用次數(shù)。

用戶代理： 在HTTP請(qǐng)求頭中設(shè)置合理的 User-Agent。

優(yōu)惠券狀態(tài)： 注意優(yōu)惠券的有效期 (coupon_start_time, coupon_end_time)，返回的優(yōu)惠券可能已過(guò)期或未開始。

多重優(yōu)惠： 復(fù)雜的營(yíng)銷活動(dòng)可能包含店鋪券、商品券、跨店滿減等疊加優(yōu)惠。此接口主要返回單品券信息，更復(fù)雜的優(yōu)惠計(jì)算需要結(jié)合其他接口或業(yè)務(wù)邏輯。

商品狀態(tài)： 檢查商品是否下架或不存在。

結(jié)語(yǔ)

通過(guò)淘寶開放平臺(tái)的 taobao.tbk.item.coupon.get 接口，開發(fā)者可以相對(duì)便捷地獲取商品的優(yōu)惠券信息并計(jì)算出券后價(jià)格。關(guān)鍵在于正確使用API參數(shù)、處理簽名、解析返回?cái)?shù)據(jù)并遵守平臺(tái)規(guī)則。希望本文能為你在開發(fā)相關(guān)功能時(shí)提供清晰的指引。如有任何疑問(wèn)，歡迎大家留言探討。

?
審核編輯 黃宇