速卖通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 = "https://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": ["https://ae01.alicdn.com/kf/HTB1.jpg"],
            "sku_property_list": [
                {
                    "property_name": "Color",
                    "values": ["Black", "White"]
                }
            ]
        }
    }
}

五、常见问题处理

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

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

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

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