速賣通（AliExpress）作為阿里巴巴旗下的國際電商平臺，提供了豐富的API接口供開發者使用，以便集成商品數據到第三方應用中。其中，一個常見的需求是通過商品ID獲取商品詳情，并支持指定貨幣和語言選項。本文將詳細介紹如何使用速賣通API實現這一功能，包括API端點、參數說明、請求示例及響應處理。本文假設您已具備基本的API調用知識，并擁有速賣通開發者賬號和API密鑰。

1. API接口概述

速賣通的商品詳情API允許開發者通過商品ID查詢商品的詳細信息，如標題、描述、價格、圖片等。該接口支持自定義語言和貨幣參數，確保返回的數據本地化，便于國際化應用。API通常采用RESTful風格，使用HTTP GET方法請求。

API端點：常見的URL格式為https://api.aliexpress.com/setup/item/get（實際URL需參考速賣通官方文檔，但本文使用通用示例）。

請求方法：GET。

認證：需要在請求頭中包含API密鑰（如Authorization: Bearer YOUR_API_KEY）。

參數：

item_id：商品ID，必填，用于指定查詢的商品。

language：語言代碼，可選，如en_US（英語）、ru_RU（俄語），默認值根據API設置。

currency：貨幣代碼，可選，如USD（美元）、EUR（歐元），默認值通常為美元。

其他可選參數：如fields用于指定返回字段，本文簡化處理。

2. API調用步驟

調用API的基本流程包括構造請求、發送請求和處理響應。以下是詳細步驟：

步驟1: 準備請求參數首先，確保您已獲取商品ID、API密鑰，并確定語言和貨幣選項。例如：

商品ID：123456789（示例ID）。

語言：en_US（英語）。

貨幣：EUR（歐元）。

步驟2: 構造請求URL將參數拼接到URL中。URL格式示例：

https://api.aliexpress.com/setup/item/get?item_id=123456789&language=en_US¤cy=EUR

步驟3: 添加請求頭在HTTP請求頭中設置認證信息。例如：

GET /setup/item/get?item_id=123456789&language=en_US¤cy=EUR HTTP/1.1 Host: api.aliexpress.com Authorization: Bearer YOUR_API_KEY Accept: application/json

3. 示例代碼：Python實現

以下Python代碼使用requests庫演示如何調用API。確保已安裝requests庫（pip install requests）。

import requests # 設置API參數 api_url = "https://api.aliexpress.com/setup/item/get" api_key = "YOUR_API_KEY" # 替換為您的API密鑰 params = { "item_id": "123456789", # 商品ID "language": "en_US", # 語言選項 "currency": "EUR" # 貨幣選項 } # 設置請求頭 headers = { "Authorization": f"Bearer {api_key}", "Accept": "application/json" } # 發送GET請求 response = requests.get(api_url, params=params, headers=headers) # 檢查響應狀態 if response.status_code == 200: # 解析JSON響應 item_data = response.json() print("商品詳情獲取成功:") print(f"標題: {item_data['title']}") print(f"價格: {item_data['price']} {params['currency']}") # 顯示指定貨幣的價格 print(f"描述: {item_data['description']}") else: print(f"請求失敗，狀態碼: {response.status_code}") print(f"錯誤信息: {response.text}")

代碼說明：

使用requests.get()發送GET請求，參數通過params字典傳遞。

響應為JSON格式，包含商品詳情字段，如title、price、description。

貨幣參數影響價格顯示，API會自動轉換貨幣值。

4. 響應處理

API響應通常為JSON對象，包含以下常見字段：

item_id：商品ID。

title：商品標題，根據語言參數本地化。

price：商品價格，根據貨幣參數轉換（例如，從美元到歐元）。

description：商品描述，本地化處理。

images：商品圖片URL列表。

其他字段：如庫存、分類等。

響應示例：

{ "item_id": "123456789", "title": "Wireless Bluetooth Headphones", "price": 29.99, "currency": "EUR", "description": "High-quality wireless headphones with noise cancellation.", "images": [ "https://example.com/image1.jpg", "https://example.com/image2.jpg" ] }

異常示例：

{
"error": "item-not-found",
"reason": "商品沒找到",
"error_code": "2000",
"success": 0,
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 0.081,
"server_time": "Beijing/2020-06-10 23:44:00",
"call_args": [],
"api_type": "aliexpress",
"request_id": "1ee0ffc041242"}

在處理價格時，如果涉及貨幣轉換，API內部使用匯率公式。例如，原始價格$P$（以美元計）轉換為歐元$E$，公式為： $$ E = P times R $$ 其中$R$是當前匯率（如美元兌歐元匯率）。但API會自動處理此計算，開發者無需手動實現。

5. 注意事項

認證與安全：始終在請求頭中使用API密鑰，避免密鑰泄露。速賣通API可能需要OAuth認證，具體參考官方文檔。

錯誤處理：檢查HTTP狀態碼：200表示成功，400表示參數錯誤，401表示認證失敗，404表示商品不存在。在代碼中添加異常處理。

速率限制：API可能有調用頻率限制（如每分鐘100次），超出會返回429錯誤。建議使用重試機制。

測試環境：先在速賣通沙盒環境中測試，避免影響生產數據。

官方文檔：速賣通API可能更新，請以速賣通開發者中心為準。

通過本文指南，您可以輕松集成速賣通商品詳情API到您的應用中，實現多語言和貨幣支持。如果有更多問題，歡迎大家留言探討。

審核編輯 黃宇