速卖通商品列表接口（以 AliExpress Affiliate 商品查询 API 为例）

以下是使用 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)

关键步骤说明：

1. 参数准备

   • 公共参数：包含应用认证信息、时间戳、签名方法等
   • 业务参数：根据官方文档调整查询条件
   • 签名密钥：app_secret 用于生成请求签名

2. 签名生成逻辑

   • 参数按名称排序后拼接
   • 使用 HMAC-SHA256 加密生成签名
   • 签名需要转换为大写字母

3. 请求发送

   • 使用 GET 方法发送请求
   • 通过 URL 参数传递所有参数
   • 实际端点请根据最新文档确认

4. 响应处理

   • 解析 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));
  

注意事项：

1. 需要先通过 OAuth2.0 流程获取 access_token
2. 商品接口可能有调用频率限制（参考官方文档）
3. 实际参数请根据最新API文档调整
4. 生产环境需要添加重试机制和错误日志
5. 敏感信息（如密钥）应通过环境变量存储

应用场景:

商品监控：商家可以定期调用该接口，监控自己或竞争对手的商品信息，如价格变动、销量情况等，以便及时调整营销策略。
数据采集与分析：开发者可以通过该接口采集大量商品数据，进行数据分析和挖掘，了解市场趋势、消费者需求等。
商品推荐：根据用户的搜索历史、浏览记录等信息，调用该接口获取相关商品列表，为用户提供个性化的商品推荐。

需要注意的是，速卖通的 API 可能会根据业务需求进行调整和更新，使用时请参考官方文档以获取最新的接口信息和使用方法。