阿里巴巴国际站商品详情接口深度解析与实战指南

官方接口地址：https://gw.api.alibaba.com/openapi/param2/2.0/aliexpress.open/api.getproductdetail

App Key = ALI_2025_XXXXXXXX
App Secret = XXXXXXXXXXXXXXXXXXXXXXXX
Access Token = (通过OAuth2.0获取，有效期2小时)

import hashlibimport hmacimport urllib.parseimport timedef generate_signature(params: dict, app_secret: str) -> str:
    """
    生成阿里巴巴API签名
    """
    # 1. 添加时间戳
    params['timestamp'] = time.strftime('%Y-%m-%d %H:%M:%S', time.localtime())
    
    # 2. 按参数名ASCII码升序排序
    sorted_params = sorted(params.items())
    
    # 3. 拼接参数
    param_str = '&'.join([f"{k}={urllib.parse.quote(str(v))}" for k, v in sorted_params])
    
    # 4. 生成签名：app_secret + 参数串 + app_secret
    sign_str = f"{app_secret}{param_str}{app_secret}"
    
    # 5. HMAC-SHA1加密并转大写
    signature = hmac.new(
        app_secret.encode('utf-8'),
        sign_str.encode('utf-8'),
        hashlib.sha1    ).hexdigest().upper()
    
    return signature

import requestsimport jsonimport timefrom typing import Dict, Optionalfrom dataclasses import dataclass@dataclassclass AlibabaConfig:
    """阿里巴巴API配置"""
    app_key: str
    app_secret: str
    access_token: str
    base_url: str = "https://gw.api.alibaba.com/openapi/param2/2.0"class AlibabaProductAPI:
    """阿里巴巴国际站商品API客户端"""
    
    def __init__(self, config: AlibabaConfig):
        self.config = config
        self.session = requests.Session()
    
    def get_product_detail(
        self, 
        product_id: str, 
        fields: str = None,
        language: str = "en",
        include_raw: bool = False
    ) -> Optional[Dict]:
        """
        获取商品详情
        
        Args:
            product_id: 商品ID
            fields: 指定返回字段，如 "subject,price_info,sku_list"
            language: 语言代码，默认英文
            include_raw: 是否包含原始HTML描述
            
        Returns:
            商品详情数据字典
        """
        # 构建请求参数
        params = {
            'app_key': self.config.app_key,
            'method': 'alibaba.product.get',
            'product_id': product_id,
            'language': language,
            'format': 'json',
            'v': '2.0',
            'sign_method': 'hmac-sha1'
        }
        
        # 添加可选字段
        if fields:
            params['fields'] = fields        if include_raw:
            params['include_raw'] = 'true'
            
        # 生成签名
        params['sign'] = self._generate_signature(params)
        params['access_token'] = self.config.access_token        
        try:
            response = self.session.get(
                f"{self.config.base_url}/aliexpress.open/api.getproductdetail",
                params=params,
                timeout=30
            )
            response.raise_for_status()
            
            result = response.json()
            
            # 检查API返回状态
            if result.get('code') == 200:
                return result.get('model', {}).get('product_detail')
            else:
                print(f"API错误: {result.get('message', '未知错误')}")
                return None
                
        except requests.exceptions.RequestException as e:
            print(f"请求异常: {str(e)}")
            return None
    
    def _generate_signature(self, params: dict) -> str:
        """生成请求签名"""
        # 移除已存在的sign参数
        params = {k: v for k, v in params.items() if k != 'sign'}
        
        # 按ASCII排序
        sorted_params = sorted(params.items())
        
        # URL编码并拼接
        param_str = '&'.join([
            f"{k}={urllib.parse.quote(str(v), safe='')}" 
            for k, v in sorted_params        ])
        
        # 生成签名
        sign_str = f"{self.config.app_secret}{param_str}{self.config.app_secret}"
        return hmac.new(
            self.config.app_secret.encode('utf-8'),
            sign_str.encode('utf-8'),
            hashlib.sha1        ).hexdigest().upper()# 使用示例if __name__ == "__main__":
    config = AlibabaConfig(
        app_key="your_app_key",
        app_secret="your_app_secret",
        access_token="your_access_token"
    )
    
    api = AlibabaProductAPI(config)
    
    # 获取商品详情
    product_id = "1600590399629"
    detail = api.get_product_detail(
        product_id=product_id,
        fields="subject,price_info,sku_list,supplier_info,trade_info",
        include_raw=True
    )
    
    if detail:
        print(f"商品标题: {detail.get('product_title')}")
        print(f"商品价格: {detail.get('product_price')}")
        print(f"SKU数量: {len(detail.get('sku_list', []))}")

{
  "request_id": "xxxx-xxxx-xxxx-xxxx",
  "code": 200,
  "message": "success",
  "model": {
    "product_detail": {
      "product_id": "123456789",
      "product_title": "Premium Wireless Bluetooth Headphones",
      "product_image_url": "https://example.com/image.jpg",
      "product_short_description": "High-quality wireless headphones with noise cancellation",
      "product_detail_description": "<p>Detailed HTML description...</p>",
      "product_price": "25.00",
      "original_price": "35.00",
      "discount": "28%",
      "currency": "USD",
      "moq": 100,
      "sku_list": [
        {
          "sku_id": "987654321",
          "sku_name": "Black-Standard",
          "sku_price": "25.00",
          "stock_quantity": 1000,
          "attributes": [
            {"attribute_name": "Color", "attribute_value": "Black"},
            {"attribute_name": "Version", "attribute_value": "Standard"}
          ]
        }
      ],
      "supplier_info": {
        "supplier_name": "XXX Electronics Co., Ltd.",
        "supplier_type": "Verified",
        "years_in_business": 8
      },
      "trade_info": {
        "orders_in_30_days": 150,
        "buyers_in_30_days": 45,
        "repeat_purchase_rate": "32%"
      }
    }
  }}