通过速卖通API获取商品详情：支持货币和语言选择

速卖通（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到您的应用中，实现多语言和货币支持。如果有更多问题，欢迎大家留言探讨。

审核编辑 黄宇