速卖通OpenAPI商品详情接口开发实战

一、接口概述

速卖通商品详情API（aliexpress.item.get）属于平台公开数据接口，需通过开放平台申请AppKey。当前版本支持：

商品基础信息（标题/价格/库存）

SKU属性及规格图

物流模板信息

商品评价统计数据

二、核心请求参数

params = { "method": "aliexpress.item.get", "app_key": "YOUR_APP_KEY", "sign_method": "md5", "timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"), "item_id": "10050012345678", # 商品ID "fields": "title,price,image_url,sku_property_list", "language": "en" # 支持en/ru/es等8种语言 }

点击获取key和secret

三、Python调用示例

import hashlib import requests from datetime import datetime

def generate_sign(secret, params): param_str = secret + ''.join(f"{k}{v}" for k,v in sorted(params.items())) return hashlib.md5(param_str.encode()).hexdigest().upper()

def get_product_detail(item_id): base_url = "api-sg.aliexpress.com/sync" params = { "method": "aliexpress.item.get", "app_key": "YOUR_APP_KEY", "item_id": item_id }

params["sign"] = generate_sign("YOUR_SECRET", params)
response = requests.get(base_url, params=params)
return response.json()

调用示例

print(get_product_detail("10050012345678"))

四、响应数据处理

典型成功响应（200）：

{ "aliexpress_item_get_response": { "item": { "title": "Wireless Bluetooth Headphones", "price": "19.99", "image_url": ["ae01.alicdn.com/kf/HTB1.jpg"], "sku_property_list": [ { "property_name": "Color", "values": ["Black", "White"] } ] } } }

五、常见问题处理

签名错误：检查时间戳时区（需UTC+8）

限流控制：默认QPS=5，建议增加重试机制

字段缺失：确认fields参数包含所需字段

多语言支持：通过language参数切换