?

在跨境電商開發(fā)中，AliExpress（速賣通）平臺(tái)提供了豐富的API接口，幫助開發(fā)者獲取商品數(shù)據(jù)。其中，獲取商品評(píng)論的API允許用戶指定地區(qū)和頁碼進(jìn)行分頁查詢，這對(duì)于分析市場(chǎng)反饋至關(guān)重要。本文將詳細(xì)介紹如何調(diào)用此API，包括準(zhǔn)備工作、參數(shù)設(shè)置、示例代碼及注意事項(xiàng)。所有內(nèi)容基于AliExpress Open Platform的公開文檔，確保真實(shí)可靠。

1. API概述

AliExpress的商品評(píng)論API用于查詢指定商品的用戶評(píng)價(jià)。核心功能包括：

支持地區(qū)篩選：通過國家代碼（如US表示美國）過濾評(píng)論來源。

分頁查詢：使用page參數(shù)指定頁碼，page_size控制每頁顯示條數(shù)（默認(rèn)為10）。

響應(yīng)格式：返回JSON數(shù)據(jù)，包含評(píng)論列表、總頁數(shù)等信息。

API端點(diǎn)通常為：

https://api.aliexpress.com/item/get_reviews

調(diào)用前需認(rèn)證，使用API key確保安全。

2. 準(zhǔn)備工作

在調(diào)用API前，需完成以下步驟：

注冊(cè)開發(fā)者賬號(hào)：訪問AliExpress Open Platform注冊(cè)，并創(chuàng)建應(yīng)用。

獲取API key：在應(yīng)用控制臺(tái)中生成app_key和app_secret，用于簽名認(rèn)證。

安裝依賴：推薦使用Python的requests庫發(fā)送HTTP請(qǐng)求。安裝命令：

pip install requests

3. API參數(shù)詳解

調(diào)用API時(shí)需傳遞以下參數(shù)（所有參數(shù)均為必填，除非注明）：

product_id：商品唯一ID（如123456789）。

country：地區(qū)代碼（ISO 3166-1 alpha-2格式），例如US（美國）、CN（中國）?？蛇x參數(shù)，未指定時(shí)返回所有地區(qū)評(píng)論。

page：頁碼（整數(shù)，從1開始），用于分頁查詢。

page_size：每頁評(píng)論數(shù)（整數(shù)，默認(rèn)為10，最大可設(shè)100）。

app_key：您的API key。

sign：請(qǐng)求簽名，通過app_secret生成（使用HMAC-SHA1算法）。

分頁邏輯：假設(shè)總評(píng)論數(shù)為$T$，每頁顯示$n$條，則總頁數(shù)$P$計(jì)算為： $$P = lceil T / n rceil$$ 其中$lceil cdot rceil$表示向上取整。

4. 示例調(diào)用（Python代碼）

以下是一個(gè)完整的Python示例，演示如何獲取商品評(píng)論（以商品ID 123456為例，地區(qū)設(shè)置為美國，頁碼為1）：

import requests
import hashlib
import hmac
import base64
import time
import json

# 配置參數(shù)
app_key = "YOUR_APP_KEY"  # 替換為您的API key
app_secret = "YOUR_APP_SECRET"  # 替換為您的API secret
product_id = "123456"
country = "US"  # 地區(qū)代碼
page = 1  # 頁碼
page_size = 20  # 每頁條數(shù)

# 生成簽名（基于AliExpress文檔規(guī)范）
def generate_sign(params, secret):
    sorted_params = sorted(params.items())
    query_str = "&".join([f"{k}{v}" for k, v in sorted_params])
    sign = hmac.new(secret.encode('utf-8'), query_str.encode('utf-8'), hashlib.sha1).digest()
    return base64.b64encode(sign).decode('utf-8')

# 構(gòu)建請(qǐng)求參數(shù)
params = {
    "method": "aliexpress.item.reviews.get",
    "app_key": app_key,
    "timestamp": str(int(time.time())),
    "product_id": product_id,
    "country": country,
    "page": page,
    "page_size": page_size,
    "format": "json",
    "v": "2.0"
}
params["sign"] = generate_sign(params, app_secret)

# 發(fā)送API請(qǐng)求
url = "https://api.aliexpress.com/router/rest"
response = requests.get(url, params=params)

# 處理響應(yīng)
if response.status_code == 200:
    data = response.json()
    reviews = data.get("aliexpress_item_reviews_get_response", {}).get("reviews", [])
    total_pages = data.get("aliexpress_item_reviews_get_response", {}).get("total_pages", 1)
    print(f"成功獲取評(píng)論！總頁數(shù): {total_pages}")
    for review in reviews:
        print(f"用戶: {review['user_name']}, 評(píng)分: {review['rating']}, 內(nèi)容: {review['content']}")
else:
    print(f"請(qǐng)求失敗，狀態(tài)碼: {response.status_code}, 錯(cuò)誤信息: {response.text}")

5. 響應(yīng)解析

API響應(yīng)為JSON格式，關(guān)鍵字段包括：

reviews：評(píng)論列表，每個(gè)評(píng)論對(duì)象包含user_name（用戶名）、rating（評(píng)分，1-5星）、content（評(píng)論內(nèi)容）等。

total_pages：總頁數(shù)（基于page_size計(jì)算）。

current_page：當(dāng)前頁碼。

示例響應(yīng)片段：

{
  "aliexpress_item_reviews_get_response": {
    "reviews": [
      {
        "user_name": "John Doe",
        "rating": 5,
        "content": "質(zhì)量非常好！",
        "country": "US"
      }
    ],
    "total_pages": 5,
    "current_page": 1
  }
}

6. 注意事項(xiàng)

頻率限制：AliExpress API有調(diào)用配額（如每秒10次），超出會(huì)返回錯(cuò)誤。使用page參數(shù)分頁時(shí)，避免高頻請(qǐng)求。

認(rèn)證安全：app_secret需保密，簽名算法防止篡改。

錯(cuò)誤處理：常見錯(cuò)誤碼包括400（參數(shù)無效）、403（認(rèn)證失敗）。檢查參數(shù)格式，例如country必須為有效代碼。

分頁優(yōu)化：當(dāng)$T$較大時(shí)，建議緩存總頁數(shù)，減少重復(fù)計(jì)算。公式$P = lceil T / n rceil$中$n$不宜過大，以防超時(shí)。

數(shù)據(jù)更新：評(píng)論數(shù)據(jù)可能延遲，實(shí)時(shí)性需結(jié)合業(yè)務(wù)需求。

通過此API，您可以高效獲取全球用戶的反饋，優(yōu)化商品策略。更多細(xì)節(jié)參考AliExpress API文檔。如有疑問，歡迎在評(píng)論區(qū)交流！

?
審核編輯 黃宇