?

在電商數(shù)據(jù)分析、店鋪管理工具開發(fā)或競(jìng)品監(jiān)控等場(chǎng)景下，通過API接口獲取淘寶店鋪的商品列表數(shù)據(jù)是一項(xiàng)常見且重要的需求。本文將介紹如何通過淘寶開放平臺(tái)的API接口實(shí)現(xiàn)這一功能。

一、 接口選擇與認(rèn)證

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

創(chuàng)建應(yīng)用：登錄淘寶開放平臺(tái)，創(chuàng)建應(yīng)用并獲取App Key和App Secret。

授權(quán)獲取Session Key：引導(dǎo)店鋪賣家通過OAuth 2.0授權(quán)流程，獲取訪問令牌access_token（即Session Key）。該令牌代表了賣家對(duì)應(yīng)用訪問其店鋪數(shù)據(jù)的授權(quán)。

二、 API請(qǐng)求基礎(chǔ)參數(shù)

調(diào)用API通常需要包含以下基礎(chǔ)參數(shù)：

method: 調(diào)用的API方法名，例如 taobao.shopitems.get。

app_key: 應(yīng)用的App Key。

session: 賣家授權(quán)后獲得的access_token。

timestamp: 請(qǐng)求發(fā)起的時(shí)間戳，格式為yyyy-MM-dd HH:mm:ss。

format: 響應(yīng)格式，通常為json或xml。

v: API版本號(hào)，例如2.0。

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

sign: 根據(jù)特定規(guī)則生成的請(qǐng)求簽名，用于驗(yàn)證請(qǐng)求合法性。

三、 獲取商品列表關(guān)鍵參數(shù)

taobao.shopitems.get接口的關(guān)鍵業(yè)務(wù)參數(shù)可能包括：

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

page_no: 頁碼，用于分頁獲取數(shù)據(jù)。

page_size: 每頁返回的商品數(shù)量（最大值受平臺(tái)限制）。

seller_nick: 賣家的昵稱（通常是授權(quán)店鋪的賣家昵稱）。

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

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

四、 簽名生成算法

簽名sign是保證請(qǐng)求安全的重要環(huán)節(jié)。生成簽名的基本步驟如下：

將所有請(qǐng)求參數(shù)（除sign本身和文件上傳參數(shù)外）按參數(shù)名的字典序排序。

將排序后的參數(shù)鍵值對(duì)連接成字符串：key1value1key2value2...。

在連接后的字符串前后拼接上應(yīng)用的App Secret。

對(duì)整個(gè)字符串使用sign_method指定的算法（如MD5或HMAC）進(jìn)行摘要計(jì)算，并將結(jié)果轉(zhuǎn)換為大寫十六進(jìn)制字符串。

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

五、 Python實(shí)現(xiàn)示例代碼

import hashlib
import time
import urllib.parse
import requests

# 配置信息
APP_KEY = 'your_app_key'
APP_SECRET = 'your_app_secret'
ACCESS_TOKEN = 'seller_access_token'  # 賣家授權(quán)后獲得
API_URL = 'https://eco.taobao.com/router/rest'  # 淘寶API網(wǎng)關(guān)地址

def generate_sign(params):
    # 1. 參數(shù)按key排序
    sorted_keys = sorted(params.keys())
    # 2. 拼接鍵值對(duì)
    param_str = ''
    for key in sorted_keys:
        param_str += key + params[key]
    # 3. 前后加App Secret
    sign_str = APP_SECRET + param_str + APP_SECRET
    # 4. 計(jì)算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):
    # 基礎(chǔ)參數(shù)
    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',
    }
    # 業(yè)務(wù)參數(shù)
    biz_params = {
        'fields': 'num_iid,title,price,pic_url',
        'page_no': str(page_no),
        'page_size': str(page_size),
        'seller_nick': 'your_seller_nick',  # 替換為實(shí)際賣家昵稱
    }
    # 合并參數(shù)
    all_params = {**base_params, **biz_params}
    # 生成簽名
    all_params['sign'] = generate_sign(all_params)
    
    # 發(fā)起請(qǐng)求
    try:
        response = requests.post(API_URL, data=all_params)
        response.raise_for_status()  # 檢查HTTP錯(cuò)誤
        result = response.json()
        # 檢查API返回的錯(cuò)誤
        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']}, 標(biāo)題: {item['title']}, 價(jià)格: {item['price']}")

六、 注意事項(xiàng)與優(yōu)化

權(quán)限與頻率限制：嚴(yán)格遵守淘寶開放平臺(tái)的API調(diào)用頻率限制（QPS）。超出限制可能導(dǎo)致調(diào)用失敗或被封禁。

錯(cuò)誤處理：代碼中應(yīng)妥善處理網(wǎng)絡(luò)錯(cuò)誤、API返回錯(cuò)誤（如無效令牌、參數(shù)錯(cuò)誤等）。

分頁獲取：對(duì)于商品數(shù)量眾多的店鋪，務(wù)必實(shí)現(xiàn)分頁邏輯，循環(huán)獲取所有頁的數(shù)據(jù)。

數(shù)據(jù)緩存：對(duì)于不常變動(dòng)的數(shù)據(jù)，可考慮在本地進(jìn)行緩存，減少API調(diào)用次數(shù)。

官方文檔：淘寶API會(huì)更新，務(wù)必以淘寶開放平臺(tái)官方文檔為準(zhǔn)，關(guān)注接口變更和參數(shù)調(diào)整。

通過上述方法，開發(fā)者可以穩(wěn)定地獲取淘寶店鋪的商品列表信息，為后續(xù)的數(shù)據(jù)分析或應(yīng)用開發(fā)提供支持。

?審核編輯 黃宇