?

在電商數據分析、店鋪管理工具開發或競品監控等場景下，通過API接口獲取淘寶店鋪的商品列表數據是一項常見且重要的需求。本文將介紹如何通過淘寶開放平臺的API接口實現這一功能。

一、 接口選擇與認證

淘寶開放平臺提供了眾多API接口，用于獲取店鋪商品列表的核心接口之一是taobao.shopitems.get（或類似功能的其他接口，具體請以官方文檔為準）。使用該接口前，需要完成以下步驟：

創建應用：登錄淘寶開放平臺，創建應用并獲取App Key和App Secret。

授權獲取Session Key：引導店鋪賣家通過OAuth 2.0授權流程，獲取訪問令牌access_token（即Session Key）。該令牌代表了賣家對應用訪問其店鋪數據的授權。

二、 API請求基礎參數

調用API通常需要包含以下基礎參數：

method: 調用的API方法名，例如 taobao.shopitems.get。

app_key: 應用的App Key。

session: 賣家授權后獲得的access_token。

timestamp: 請求發起的時間戳，格式為yyyy-MM-dd HH:mm:ss。

format: 響應格式，通常為json或xml。

v: API版本號，例如2.0。

sign_method: 簽名方式，通常為md5或hmac。

sign: 根據特定規則生成的請求簽名，用于驗證請求合法性。

三、 獲取商品列表關鍵參數

taobao.shopitems.get接口的關鍵業務參數可能包括：

fields (必需): 指定需要返回的商品字段。例如：num_iid,title,price,pic_url,approve_status,list_time,modified等。建議只獲取需要的字段以減少帶寬消耗。

page_no: 頁碼，用于分頁獲取數據。

page_size: 每頁返回的商品數量（最大值受平臺限制）。

seller_nick: 賣家的昵稱（通常是授權店鋪的賣家昵稱）。

order_by: 排序字段，如list_time(上架時間), modified(修改時間), sold_quantity(銷量)等。

sort: 排序方式，asc(升序)或desc(降序)。

四、 簽名生成算法

簽名sign是保證請求安全的重要環節。生成簽名的基本步驟如下：

將所有請求參數（除sign本身和文件上傳參數外）按參數名的字典序排序。

將排序后的參數鍵值對連接成字符串：key1value1key2value2...。

在連接后的字符串前后拼接上應用的App Secret。

對整個字符串使用sign_method指定的算法（如MD5或HMAC）進行摘要計算，并將結果轉換為大寫十六進制字符串。

例如，如果使用MD5： $$ text{sign} = text{toUpperCase}(text{MD5}( text{AppSecret} + text{sorted_params_string} + text{AppSecret} )) $$

五、 Python實現示例代碼

import hashlib
import time
import urllib.parse
import requests

# 配置信息
APP_KEY = 'your_app_key'
APP_SECRET = 'your_app_secret'
ACCESS_TOKEN = 'seller_access_token'  # 賣家授權后獲得
API_URL = 'https://eco.taobao.com/router/rest'  # 淘寶API網關地址

def generate_sign(params):
    # 1. 參數按key排序
    sorted_keys = sorted(params.keys())
    # 2. 拼接鍵值對
    param_str = ''
    for key in sorted_keys:
        param_str += key + params[key]
    # 3. 前后加App Secret
    sign_str = APP_SECRET + param_str + APP_SECRET
    # 4. 計算MD5簽名
    md5 = hashlib.md5()
    md5.update(sign_str.encode('utf-8'))
    return md5.hexdigest().upper()

def get_shop_items(page_no=1, page_size=10):
    # 基礎參數
    base_params = {
        'method': 'taobao.shopitems.get',
        'app_key': APP_KEY,
        'session': ACCESS_TOKEN,
        'timestamp': time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()),
        'format': 'json',
        'v': '2.0',
        'sign_method': 'md5',
    }
    # 業務參數
    biz_params = {
        'fields': 'num_iid,title,price,pic_url',
        'page_no': str(page_no),
        'page_size': str(page_size),
        'seller_nick': 'your_seller_nick',  # 替換為實際賣家昵稱
    }
    # 合并參數
    all_params = {**base_params, **biz_params}
    # 生成簽名
    all_params['sign'] = generate_sign(all_params)
    
    # 發起請求
    try:
        response = requests.post(API_URL, data=all_params)
        response.raise_for_status()  # 檢查HTTP錯誤
        result = response.json()
        # 檢查API返回的錯誤
        if result.get('error_response'):
            print(f"API Error: {result['error_response']['msg']}")
            return None
        return result.get('shopitems_get_response', {}).get('items', [])
    except Exception as e:
        print(f"Request Error: {e}")
        return None

# 獲取第一頁商品
items = get_shop_items(page_no=1, page_size=10)
if items:
    for item in items['item']:
        print(f"商品ID: {item['num_iid']}, 標題: {item['title']}, 價格: {item['price']}")

六、 注意事項與優化

權限與頻率限制：嚴格遵守淘寶開放平臺的API調用頻率限制（QPS）。超出限制可能導致調用失敗或被封禁。

錯誤處理：代碼中應妥善處理網絡錯誤、API返回錯誤（如無效令牌、參數錯誤等）。

分頁獲取：對于商品數量眾多的店鋪，務必實現分頁邏輯，循環獲取所有頁的數據。

數據緩存：對于不常變動的數據，可考慮在本地進行緩存，減少API調用次數。

官方文檔：淘寶API會更新，務必以淘寶開放平臺官方文檔為準，關注接口變更和參數調整。

通過上述方法，開發者可以穩定地獲取淘寶店鋪的商品列表信息，為后續的數據分析或應用開發提供支持。

?審核編輯 黃宇