在電商開發這片江湖闖蕩了八年，遭遇過的難題多如牛毛，其中淘寶買家秀 API 接口的對接經歷，更是一段充滿波折與驚喜的 “冒險”。今天，就來給大伙講講這背后的故事，順便分享些經過實戰打磨的代碼干貨，讓大家少走點彎路，更高效地獲取淘寶買家秀數據。

還記得初次接觸淘寶買家秀 API接口時，那叫一個信心滿滿，覺得不就是按文檔調個接口，獲取點數據嘛，能有多難？結果現實立馬給了我一記響亮的耳光。申請接入的過程就不順利，淘寶開放平臺對開發者資質審核相當嚴格，各種資料反復提交、修改，足足等了三個工作日才通過。注冊拿到[App Key]和[App Secret]，本以為勝利在望，誰知道[簽名驗證]又成了攔路虎。淘寶的簽名算法在文檔里寫得晦澀難懂，參數排序、加密方式稍有差錯，就會收到`40001`簽名錯誤提示。我對著文檔研究了整整兩天，眼睛都快瞪出火花了，還在各大技術論壇瘋狂搜索，終于寫出了正確的簽名生成函數：

python

```
import hashlib
import hmac
import time
import urllib.parse

def generate_sign(params, app_secret):
sorted_params = sorted(params.items(), key=lambda x: x[0])
sign_str = app_secret
for k, v in sorted_params:
sign_str += f"{k}{v}"
sign_str += app_secret
return hmac.new(
app_secret.encode(), sign_str.encode(), hashlib.sha256
).hexdigest().upper()
```

解決了簽名問題，本以為能順風順水調用接口了，可新的麻煩接踵而至。接口調用頻率限制讓我頭疼不已，當時為了快速采集大量買家秀數據，沒控制好請求頻率，短時間內發送了太多請求，結果直接被淘寶封了 IP，還收到警告郵件。這下只能乖乖研究淘寶的限流規則，用[漏桶算法]寫了個頻率控制類，來限制請求發送的頻率：

python

```
import time

class LeakyBucket:
def __init__(self, capacity, rate):
self.capacity = capacity
self.rate = rate
self.tokens = capacity
self.last_update = time.time()

def consume(self, tokens=1):
now = time.time()
# 補充令牌
self.tokens = min(
self.capacity, self.tokens + (now - self.last_update) * self.rate
)
self.last_update = now

if self.tokens >= tokens:
self.tokens -= tokens
return True
return False

# 使用示例
bucket = LeakyBucket(capacity=100, rate=20) # 容量100，每秒補充20個令牌
if bucket.consume():
# 調用API
response = requests.get(api_url)
else:
time.sleep(0.1) # 等待令牌補充
```

python數據實例

```
{
"items": {
"total_results": 2000,
"totalpage": 1000,
"page_size": 20,
"has_more": "true",
"uuid": "eb189144-7814-443f-b68a-0401be50be02",
"page": 0,
"item": [
{
"rate_content": "好好好",
"display_user_nick": "雨天",
"pics": null,
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/429445756537.mp4"
},
{
"rate_content": "好康好康",
"display_user_nick": "y-z^o^",
"pics": null,
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/431029819603.mp4"
},
{
"rate_content": "收到貨啦，發貨速度很快，好喜歡這個外套，質量好，穿上修身很顯瘦！！愛了愛了",
"display_user_nick": "仙女n",
"pics": null,
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/424509061030.mp4"
},
{
"rate_content": "衣服很好看，和圖片呈現效果一模一樣，沒有色差，非常修身，穿出來很有氣質，材質也很好，秋冬穿正好合適，非常滿意，是一次很不錯的購物體驗",
"display_user_nick": "櫻時小涵",
"pics": [
"https://gw2.alicdn.com/tfscom/O1CN01MlKqDZ1pG6h7clTmn_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01iuPVia1pG6h5k9MVW_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01wvqHqu1pG6h3s6tey_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01NmW36k1pG6h2dBSJi_!!0-tbbala.jpg"
],
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/424509061030.mp4"
},
{
"rate_content": "外套特別好看，是我最喜歡的粉色粉粉嫩嫩的，版型特別顯瘦，搭配裙子或者褲子都超好看",
"display_user_nick": "自然醒",
"pics": [
"https://gw2.alicdn.com/tfscom/O1CN01MlKqDZ1pG6h7clTmn_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01iuPVia1pG6h5k9MVW_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01wvqHqu1pG6h3s6tey_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01NmW36k1pG6h2dBSJi_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01jTGm5h2LCVIvEtncc_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01M3JUaz2LCVIwI1COw_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01JGVtVx2LCVIziN0zg_!!0-tbbala.jpg"
],
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/424509061030.mp4"
},
{
"rate_content": "面料很好穿的很合身",
"display_user_nick": "公主沒煩惱",
"pics": [
"https://gw2.alicdn.com/tfscom/O1CN01MlKqDZ1pG6h7clTmn_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01iuPVia1pG6h5k9MVW_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01wvqHqu1pG6h3s6tey_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01NmW36k1pG6h2dBSJi_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01jTGm5h2LCVIvEtncc_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01M3JUaz2LCVIwI1COw_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01JGVtVx2LCVIziN0zg_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01gbwwsj1d1epRAa51i_!!0-tbbala.jpg",
"https://gw.alicdn.com/tfscom/O1CN01nItKpz1d1epHIyBHa_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01IiBbNd1d1epPAC0UM_!!0-tbbala.jpg"
],
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/424509061030.mp4"
},
{
"rate_content": "尺碼合適 超級喜歡！",
"display_user_nick": "就就",
"pics": [
"https://gw2.alicdn.com/tfscom/O1CN01MlKqDZ1pG6h7clTmn_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01iuPVia1pG6h5k9MVW_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01wvqHqu1pG6h3s6tey_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01NmW36k1pG6h2dBSJi_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01jTGm5h2LCVIvEtncc_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01M3JUaz2LCVIwI1COw_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01JGVtVx2LCVIziN0zg_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01gbwwsj1d1epRAa51i_!!0-tbbala.jpg",
"https://gw.alicdn.com/tfscom/O1CN01nItKpz1d1epHIyBHa_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01IiBbNd1d1epPAC0UM_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01C2wRXm1TfN3XDuues_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01N9dljz1TfN3XDuAwR_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01cEKlX21TfN3PWgYlJ_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01t8daCX1TfN3cHSiV2_!!0-tbbala.jpg"
],
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/424509061030.mp4"
},
{
"rate_content": "真的超級好看誰懂啊非常顯瘦 面料也很舒服",
"display_user_nick": "敲醒了月亮9",
"pics": [
"https://gw2.alicdn.com/tfscom/O1CN01MlKqDZ1pG6h7clTmn_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01iuPVia1pG6h5k9MVW_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01wvqHqu1pG6h3s6tey_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01NmW36k1pG6h2dBSJi_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01jTGm5h2LCVIvEtncc_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01M3JUaz2LCVIwI1COw_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01JGVtVx2LCVIziN0zg_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01gbwwsj1d1epRAa51i_!!0-tbbala.jpg",
"https://gw.alicdn.com/tfscom/O1CN01nItKpz1d1epHIyBHa_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01IiBbNd1d1epPAC0UM_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01C2wRXm1TfN3XDuues_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01N9dljz1TfN3XDuAwR_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01cEKlX21TfN3PWgYlJ_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01t8daCX1TfN3cHSiV2_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN014mKjlx1lrQVaeT6YU_!!0-tbbala.jpg",
"https://gw.alicdn.com/tfscom/O1CN01RswQSs1lrQVhSr3c8_!!0-tbbala.jpg"
],
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/424509061030.mp4"
},
{
"rate_content": "這款粉色修身外套真的肌理感很強 整體版型也很好 質感簡直拉滿 拍照超出片 真的很喜歡?衣服穿了好幾次都不起球 u0014?洗了幾次也不掉色 質量真的很好 這個價格也很合適 想不到這個價格能買到這樣超質量的衣服",
"display_user_nick": "程龍平131",
"pics": [
"https://gw2.alicdn.com/tfscom/O1CN01MlKqDZ1pG6h7clTmn_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01iuPVia1pG6h5k9MVW_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01wvqHqu1pG6h3s6tey_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01NmW36k1pG6h2dBSJi_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01jTGm5h2LCVIvEtncc_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01M3JUaz2LCVIwI1COw_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01JGVtVx2LCVIziN0zg_!!0-tbbala.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01gbwwsj1d1epRAa51i_!!0-tbbala.jpg",
"https://gw.alicdn.com/tfscom/O1CN01nItKpz1d1epHIyBHa_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01IiBbNd1d1epPAC0UM_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN01C2wRXm1TfN3XDuues_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01N9dljz1TfN3XDuAwR_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01cEKlX21TfN3PWgYlJ_!!0-tbbala.jpg",
"https://gw1.alicdn.com/tfscom/O1CN01t8daCX1TfN3cHSiV2_!!0-tbbala.jpg",
"https://gw3.alicdn.com/tfscom/O1CN014mKjlx1lrQVaeT6YU_!!0-tbbala.jpg",
"https://gw.alicdn.com/tfscom/O1CN01RswQSs1lrQVhSr3c8_!!0-tbbala.jpg",
"https://gw.alicdn.com/tfscom/O1CN015Jv7BE1oN9CF28EBo_!!2-rate.png",
"https://gw2.alicdn.com/tfscom/O1CN01UcBhcj1oN9CDQXKpm_!!0-rate.jpg",
"https://gw2.alicdn.com/tfscom/O1CN01NWmWdz1oN9CEF0L2f_!!2-rate.png",
"https://gw2.alicdn.com/tfscom/O1CN01dJ67Wi1oN9CC48Gp7_!!2-rate.png",
"https://gw.alicdn.com/tfscom/O1CN01jI0rTW1oN9C9AAAcU_!!2-rate.png"
],
"video": "http://cloud.video.taobao.com/play/u/null/p/1/d/hd/e/6/t/1/424509061030.mp4"
```

數據到手后，才發現這只是萬里長征第一步。淘寶買家秀數據格式極為復雜，包含文字評論、圖片、視頻、評分、追評等多種類型，不同類型數據結構差異巨大。拿圖片處理來說，買家上傳的圖片尺寸、格式各不相同，要在頁面上合理展示，得進行大量格式轉換和尺寸縮放操作。為了處理這些問題，我引入了`Pillow`圖像處理庫，寫了個圖片格式統一和尺寸調整函數：

python

```
from PIL import Image
import os

def process_image(image_path, target_size=(800, 600), output_format="JPEG"):
try:
img = Image.open(image_path)
img = img.resize(target_size, Image.ANTIALIAS)
output_path = os.path.splitext(image_path)[0] + f".{output_format.lower()}"
img.save(output_path, output_format)
return output_path
except Exception as e:
print(f"圖片處理錯誤: {e}")
return None

# 示例調用
image_path = "path/to/your/image.jpg"
processed_image = process_image(image_path)
```

還有一回，客戶要求實時監控自家商品買家秀，一有新內容就及時推送通知。這可難不倒我，通過設置合適的時間間隔，不斷調用淘寶買家秀 API 獲取最新數據。但很快又出現新問題，每次獲取買家秀都要從第一頁開始查，效率極低。后來我發現接口可以通過評論時間戳來篩選，只獲取上次查詢時間之后的新內容，大大提高了效率，代碼如下：

python

```
import requests
import time

# 假設last_query_time是上次查詢時間戳
def get_new_buyer_shows(last_query_time, app_key, app_secret, num_iid):
params = {
"method": "taobao.item_review_show",
"app_key": app_key,
"num_iid": num_iid,
"start_date": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(last_query_time)),
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"format": "json",
"v": "2.0",
}
params["sign"] = generate_sign(params, app_secret)
response = requests.get(
"https://eco.taobao.com/router/rest", params=params
)
data = response.json()
if data["code"] == "200":
new_buyer_shows = data["item_review_show_response"]["reviews"]
return new_buyer_shows
else:
print(f"錯誤碼: {data['code']}, 消息: {data.get('msg', '未知錯誤')}")
return []

# 示例調用
last_query_time = 1690000000 # 假設初始時間戳
app_key = "your_app_key"
app_secret = "your_app_secret"
num_iid = "123456789" # 商品ID
new_buyer_shows = get_new_buyer_shows(last_query_time, app_key, app_secret, num_iid)
if new_buyer_shows:
for show in new_buyer_shows:
print(f"用戶: {show['user_nick']}, 評論: {show['rate_content']}")
```

在開發一個電商商品分析平臺時，需要將買家秀數據和商品其他信息整合展示，還要對大量數據進行高效存儲和查詢。我選用了`MongoDB`數據庫，因為它的文檔型結構非常適合存儲這種格式多變的買家秀數據。為了實現數據的快速插入和查詢，編寫了以下操作數據庫的函數：

python

```
from pymongo import MongoClient

def connect_mongo():
client = MongoClient("mongodb://localhost:27017/")
return client["your_database_name"]

def insert_buyer_show(db, buyer_show_data):
collection = db["buyer_shows"]
result = collection.insert_one(buyer_show_data)
return result.inserted_id

def get_buyer_shows_by_item_id(db, num_iid):
collection = db["buyer_shows"]
return list(collection.find({"num_iid": num_iid}))

# 示例調用
db = connect_mongo()
new_show = {
"num_iid": "123456789",
"user_nick": "example_user",
"rate_content": "商品很不錯",
"pics": ["pic_url_1", "pic_url_2"]
}
inserted_id = insert_buyer_show(db, new_show)
shows = get_buyer_shows_by_item_id(db, "123456789")
```

這些年在淘寶買家秀 API 接口開發上，靠著不斷踩坑、填坑，積累了不少實戰經驗。每次攻克一個難題，都感覺自己在技術之路上又邁進了一大步

審核編輯 黃宇