?

在電商開發中，集成亞馬遜平臺的商品搜索功能是常見需求。通過亞馬遜的Product Advertising API（PAAPI），開發者可以根據關鍵字高效檢索商品信息。本技術帖將逐步介紹如何調用此API，包括獲取權限、發送請求、解析響應及注意事項。所有內容基于官方文檔，確保真實可靠。

1. API簡介與用途

亞馬遜的Product Advertising API（PAAPI）是一個RESTful接口，允許開發者通過關鍵字搜索商品。主要功能包括：

根據關鍵詞返回相關商品列表。

獲取商品詳情，如標題、價格、圖片等。

支持分頁和過濾，提升搜索精準度。 此API適用于構建比價工具、商品推薦系統或市場分析應用。例如，輸入關鍵詞“藍牙耳機”，API返回匹配商品的數據。

2. 獲取API訪問權限

在使用API前，需完成注冊和認證：

步驟1：注冊為Amazon Associate
訪問Amazon Associates官網，創建賬戶并同意條款。審核通過后，獲得“Partner Tag”（關聯ID）。

步驟2：申請API密鑰
在Amazon Advertising控制臺中，生成“Access Key”和“Secret Key”。這些密鑰用于請求簽名，確保安全。

步驟3：了解限制
PAAPI有免費額度（每月請求限制），超出需付費。嚴格遵守亞馬遜政策，避免濫用。

3. API接口詳解

搜索商品的核心端點是SearchItems，使用HTTP GET方法。主要參數如下：

必需參數：

Keywords：搜索關鍵字，例如“手機”。

PartnerTag：您的Amazon Associate ID。

AccessKey：API訪問密鑰。

SecretKey：用于生成簽名的密鑰（不在請求中直接發送）。

可選參數：

ItemPage：分頁頁碼（默認1）。

SearchIndex：搜索類別（如“Electronics”）。

請求格式：
請求需包括簽名頭（Authorization Header），簽名算法基于HMAC-SHA256。公式為：
$$ text{簽名} = text{HMAC}(text{SecretKey}, text{規范化字符串}) $$
其中規范化字符串包含時間戳、請求方法等。

響應格式：
響應為JSON，結構包括：

SearchResult：包含商品列表的數組。

每個商品有ASIN（唯一ID）、Title、Price等字段。

錯誤時返回錯誤碼，如“InvalidParameter”。

4. 示例調用代碼

以下Python代碼演示如何調用API。使用requests和urllib庫處理簽名。確保安裝依賴：pip install requests。

import requests
import urllib.parse
import hmac
import hashlib
import datetime

# 配置參數（替換為您的實際值）
access_key = "YOUR_ACCESS_KEY"
secret_key = "YOUR_SECRET_KEY"
partner_tag = "YOUR_PARTNER_TAG"
keywords = "藍牙耳機"  # 搜索關鍵字

# 生成簽名和請求URL
def generate_request_url():
    # 基礎URL和參數
    base_url = "https://webservices.amazon.com/paapi5/searchitems"
    params = {
        "Keywords": keywords,
        "PartnerTag": partner_tag,
        "AccessKey": access_key,
        "Timestamp": datetime.datetime.utcnow().strftime("%Y-%m-%dT%H:%M:%SZ")
    }
    # 規范化參數并生成簽名
    sorted_params = sorted(params.items())
    query_string = urllib.parse.urlencode(sorted_params)
    string_to_sign = f"GETnwebservices.amazon.comn/paapi5/searchitemsn{query_string}"
    signature = hmac.new(secret_key.encode(), string_to_sign.encode(), hashlib.sha256).digest()
    signature_encoded = urllib.parse.quote(base64.b64encode(signature))
    
    # 添加簽名到URL
    full_url = f"{base_url}?{query_string}&Signature={signature_encoded}"
    return full_url

# 發送請求并處理響應
try:
    url = generate_request_url()
    headers = {"Accept": "application/json"}
    response = requests.get(url, headers=headers)
    
    if response.status_code == 200:
        data = response.json()
        # 解析商品列表
        for item in data.get("SearchResult", {}).get("Items", []):
            title = item.get("ItemInfo", {}).get("Title", {}).get("DisplayValue", "N/A")
            price = item.get("Offers", {}).get("Listings", [{}])[0].get("Price", {}).get("DisplayAmount", "N/A")
            print(f"商品: {title}, 價格: {price}")
    else:
        print(f"請求失敗: 狀態碼 {response.status_code}, 錯誤: {response.text}")
except Exception as e:
    print(f"發生異常: {str(e)}")

5. 解析響應數據

API響應是JSON對象，關鍵字段包括：

SearchResult.Items[]：商品數組。

每個商品有：

ASIN：商品唯一標識。

DetailPageURL：商品詳情頁鏈接。

ItemInfo.Title.DisplayValue：商品標題。

Offers.Listings[0].Price.DisplayAmount：價格。 解析時，檢查錯誤字段如Errors，處理常見錯誤如“InvalidAccessKey”。

6. 注意事項

速率限制：免費層限1000請求/天，超出需升級。監控使用量，避免封禁。

簽名安全：SecretKey必須保密，不在客戶端存儲。使用環境變量管理密鑰。

政策遵守：僅用于合法用途，不得抓取禁止數據。亞馬遜可能更新API版本，需關注文檔。

錯誤處理：添加重試邏輯，應對網絡問題。使用指數退避算法：
$$ text{等待時間} = text{基礎間隔} times 2^{text{嘗試次數}} $$

性能優化：緩存頻繁搜索結果，減少API調用。

7. 總結

通過PAAPI，開發者能高效集成亞馬遜商品搜索功能。本指南覆蓋了從注冊到代碼實現的完整流程。建議先測試沙箱環境，再部署生產。更多細節參考官方文檔。如有疑問，歡迎在評論區討論！

?審核編輯 黃宇