速卖通（AliExpress）作为阿里巴巴旗下的国际电商平台，提供了丰富的API接口供开发者使用，以便集成商品数据到第三方应用中。其中，一个常见的需求是通过商品ID获取商品详情，并支持指定货币和语言选项。本文将详细介绍如何使用速卖通API实现这一功能，包括API端点、参数说明、请求示例及响应处理。本文假设您已具备基本的API调用知识，并拥有速卖通开发者账号和API密钥。
- 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用于指定返回字段，本文简化处理。
- 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
- 示例代码：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会自动转换货币值。
- 响应处理
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会自动处理此计算，开发者无需手动实现。
- 注意事项
认证与安全：始终在请求头中使用API密钥，避免密钥泄露。速卖通API可能需要OAuth认证，具体参考官方文档。
错误处理：检查HTTP状态码：200表示成功，400表示参数错误，401表示认证失败，404表示商品不存在。在代码中添加异常处理。
速率限制：API可能有调用频率限制（如每分钟100次），超出会返回429错误。建议使用重试机制。
测试环境：先在速卖通沙盒环境中测试，避免影响生产数据。
官方文档：速卖通API可能更新，请以速卖通开发者中心为准。
通过本文指南，您可以轻松集成速卖通商品详情API到您的应用中，实现多语言和货币支持。如果有更多问题，欢迎大家留言探讨。
