以下是使用 Python 调用速卖通商品列表接口（以 AliExpress Affiliate 商品查询 API 为例）的代码示例，包含关键步骤和注释说明：
import requests
import hashlib
import hmac
import time
from urllib.parse import urlencode
# 1. 准备基础参数
app_key = "YOUR_APP_KEY" # 替换为你的应用Key
app_secret = "YOUR_APP_SECRET" # 替换为你的应用密钥
access_token = "YOUR_ACCESS_TOKEN" # OAuth2授权后的Token
# 公共参数
public_params = {
"app_key": app_key,
"sign_method": "sha256",
"timestamp": str(int(time.time() * 1000)), # 毫秒级时间戳
"access_token": access_token,
"v": "2.0" # API版本
}
# 业务参数（根据API文档调整）
business_params = {
"category_ids": "", # 可选类目ID
"keywords": "phone", # 搜索关键词
"page_no": 1, # 页码
"page_size": 10, # 每页数量
"sort": "priceAsc", # 排序方式
"target_currency": "USD", # 目标货币
"target_language": "en" # 目标语言
}
# 2. 生成签名
def generate_sign(params, app_secret):
# 将所有参数按key排序
sorted_params = sorted(params.items(), key=lambda x: x[0])
# 拼接键值对
query_str = '&'.join([f"{k}{v}" for k, v in sorted_params])
# 使用HMAC-SHA256加密
signature = hmac.new(
app_secret.encode('utf-8'),
query_str.encode('utf-8'),
digestmod=hashlib.sha256
).hexdigest().upper()
return signature
# 合并参数
all_params = {
**public_params, **business_params}
all_params["sign"] = generate_sign(all_params, app_secret)
# 3. 发送请求
api_url = "https://api-sg.aliexpress.com/sync"
response = requests.get(f"{api_url}?{urlencode(all_params)}")
# 4. 处理响应
if response.status_code == 200:
data = response.json()
if "result" in data:
products = data["result"]["products"]
for product in products:
print(f"商品ID: {product['product_id']}")
print(f"标题: {product['product_title']}")
print(f"价格: {product['target_sale_price']} {product['target_currency']}")
print("-------------------")
else:
print("API返回错误:", data.get("error_msg"))
else:
print("请求失败，状态码:", response.status_code)
关键步骤说明：
参数准备
- 公共参数：包含应用认证信息、时间戳、签名方法等
- 业务参数：根据官方文档调整查询条件
- 签名密钥：
app_secret用于生成请求签名
签名生成逻辑
- 参数按名称排序后拼接
- 使用 HMAC-SHA256 加密生成签名
- 签名需要转换为大写字母
请求发送
- 使用 GET 方法发送请求
- 通过 URL 参数传递所有参数
- 实际端点请根据最新文档确认
响应处理
- 解析 JSON 数据
- 处理商品列表数据
- 错误处理逻辑
其他语言示例（Java/PHP） 可参考类似逻辑：
Java 使用
OkHttp+HmacUtils：// 生成签名示例 String signStr = params.entrySet().stream() .sorted(Map.Entry.comparingByKey()) .map(e -> e.getKey() + e.getValue()) .collect(Collectors.joining()); String sign = HmacUtils.hmacSha256Hex(appSecret, signStr).toUpperCase();PHP 使用 cURL：
// 生成签名 ksort($params); $signStr = implode('', array_map(function($k, $v) { return $k.$v; }, array_keys($params), $params)); $sign = strtoupper(hash_hmac('sha256', $signStr, $app_secret));
注意事项：
- 需要先通过 OAuth2.0 流程获取
access_token - 商品接口可能有调用频率限制（参考官方文档）
- 实际参数请根据最新API文档调整
- 生产环境需要添加重试机制和错误日志
- 敏感信息（如密钥）应通过环境变量存储
应用场景:
商品监控：商家可以定期调用该接口，监控自己或竞争对手的商品信息，如价格变动、销量情况等，以便及时调整营销策略。
数据采集与分析：开发者可以通过该接口采集大量商品数据，进行数据分析和挖掘，了解市场趋势、消费者需求等。
商品推荐：根据用户的搜索历史、浏览记录等信息，调用该接口获取相关商品列表，为用户提供个性化的商品推荐。
需要注意的是，速卖通的 API 可能会根据业务需求进行调整和更新，使用时请参考官方文档以获取最新的接口信息和使用方法。
