速卖通商品详情接口完全指南：从联盟 API 到开放平台的全链路实战

sign = HMAC-SHA256( app_secret, 所有参数按 key 升序拼接 ).upper()

import requests
import hashlib
import hmac
import time
from urllib.parse import urlencode
APP_KEY = 'your_app_key'
APP_SECRET = 'your_app_secret'
ACCESS_TOKEN = 'your_access_token'
def generate_sign(params, app_secret):
    # 按 key 升序排序
    sorted_params = sorted(params.items(), key=lambda x: x[0])
    # 拼接成 key=value 字符串（无分隔符）
    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
def get_affiliate_product_detail(product_ids, target_currency='USD', target_language='en'):
    """
    获取联盟商品详情
    product_ids: 商品ID列表，如 ['33006951782', '32979201404']
    """
    timestamp = str(int(time.time() * 1000))
    
    # 公共参数
    public_params = {
        "app_key": APP_KEY,
        "sign_method": "sha256",
        "timestamp": timestamp,
        "access_token": ACCESS_TOKEN,
        "v": "2.0"
    }
    
    # 业务参数
    business_params = {
        "product_ids": ','.join(product_ids),
        "target_currency": target_currency,
        "target_language": target_language
    }
    
    # 合并参数并生成签名
    all_params = {**public_params, **business_params}
    all_params["sign"] = generate_sign(all_params, APP_SECRET)
    
    # 发送请求
    api_url = "https://api-sg.aliexpress.com/sync"
    response = requests.get(f"{api_url}?{urlencode(all_params)}", timeout=30)
    
    if response.status_code == 200:
        return response.json()
    else:
        print(f"请求失败: {response.status_code}, {response.text}")
        return None
# 调用示例
result = get_affiliate_product_detail(['33006951782'])
print(result)

{
    "aliexpress_affiliate_productdetail_get_response": {
        "resp_result": {
            "resp_code": 200,
            "resp_msg": "success",
            "result": {
                "current_record_count": 1,
                "products": {
                    "product": [
                        {
                            "product_id": "33006951782",
                            "product_title": "Spring Autumn mother daughter dress matching family outfits...",
                            "product_small_image_urls": {
                                "string": ["https://ae01.alicdn.com/..."]
                            },
                            "sale_price": 15.9,
                            "sale_price_currency": "USD",
                            "app_sale_price": 14.5,
                            "app_sale_price_currency": "USD",
                            "original_price": 30.0,
                            "original_price_currency": "USD",
                            "discount": "50%",
                            "commission_rate": "3.5%",
                            "evaluate_rate": "89.22%",
                            "lastest_volume": 300,
                            "shop_id": "111111",
                            "first_level_category_name": "dress",
                            "second_level_category_name": "Women's Clothing",
                            "promo_code_info": {
                                "promo_code": "GMG20207",
                                "code_value": "On order over USD 10, get USD 7 off",
                                "code_availabletime_start": "2020-04-01 00:00:00",
                                "code_availabletime_end": "2020-04-30 23:59:59"
                            },
                            "target_sale_price": 320.2,
                            "target_sale_price_currency": "USD"
                        }
                    ]
                }
            }
        }
    }
}

{
    "aliexpress_solution_product_detail_get_response": {
        "result": {
            "product_id": "32979201404",
            "subject": "Smart Watch Men Women Blood Pressure Heart Rate Monitor...",
            "language": "en",
            "category_id": 200000705,
            "product_status_type": "onSelling",
            "ws_display": "110000",
            "product_price": "25.99",
            "product_unit": 1,
            "delivery_time": 15,
            "store_info": {
                "store_id": 243686854,
                "store_name": "Smart Watch Store",
                "store_rating": 4.8
            },
            "sku_infos": {
                "sku_info": [
                    {
                        "sku_id": "12000027123456789",
                        "sku_price": "25.99",
                        "sku_stock": 326,
                        "sku_property": [
                            {
                                "property_name": "Color",
                                "property_value": "Black"
                            },
                            {
                                "property_name": "Size",
                                "property_value": "44mm"
                            }
                        ],
                        "sku_code": "SW-BLK-44",
                        "sku_image": "https://ae01.alicdn.com/...",
                        "ipm_sku_stock": 326
                    }
                ]
            },
            "image_urls": {
                "string": [
                    "https://ae01.alicdn.com/...",
                    "https://ae01.alicdn.com/..."
                ]
            },
            "detail": "<html>商品详情富文本...</html>",
            "properties": {
                "property": [
                    {
                        "attr_name": "Language",
                        "attr_value": "English,Spanish,French"
                    },
                    {
                        "attr_name": "Band Material",
                        "attr_value": "Silica"
                    }
                ]
            },
            "freight_template_id": 123456,
            "package_info": {
                "package_length": 10,
                "package_width": 8,
                "package_height": 5,
                "gross_weight": 0.3
            },
            "evaluation": {
                "star_rating": 4.7,
                "total_evaluations": 1523
            }
        }
    }
}

def search_and_get_detail(keyword, page_size=10):
    """
    先搜索商品，再获取详情
    """
    # 1. 搜索商品
    search_params = {
        "app_key": APP_KEY,
        "sign_method": "sha256",
        "timestamp": str(int(time.time() * 1000)),
        "access_token": ACCESS_TOKEN,
        "v": "2.0",
        "method": "aliexpress.item.search",
        "keywords": keyword,
        "page_size": page_size,
        "sort": "saleDesc",
        "target_currency": "USD",
        "target_language": "en"
    }
    search_params["sign"] = generate_sign(search_params, APP_SECRET)
    
    api_url = "https://api-sg.aliexpress.com/sync"
    search_resp = requests.get(f"{api_url}?{urlencode(search_params)}")
    search_data = search_resp.json()
    
    # 2. 提取商品ID列表
    items = search_data.get("result", {}).get("items", [])
    product_ids = [item.get("product_id") for item in items]
    
    # 3. 批量获取详情
    if product_ids:
        detail = get_affiliate_product_detail(product_ids[:50])
        return detail
    
    return None