深入 HTTP 协议：剖析 1688 商品详情 API 的请求构造与签名机制

import requests
import hashlib
import time
import urllib.parse

class Ali1688API:
    def __init__(self, app_key, app_secret):
        self.app_key = app_key
        self.app_secret = app_secret
        self.base_url = "https://gw.open.1688.com/openapi/param2/2.0/"
    
    def _generate_sign(self, params):
        """生成签名"""
        # 1. 按参数名ASCII码升序排序
        sorted_params = sorted(params.items(), key=lambda x: x[0])
        
        # 2. 拼接成"参数名=参数值"的形式，用&连接
        sign_str = "&".join([f"{k}={v}" for k, v in sorted_params])
        
        # 3. 首尾拼接app_secret
        sign_str = f"{self.app_secret}{sign_str}{self.app_secret}"
        
        # 4. MD5加密并转为大写
        sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
        return sign
    
    def get_product_details(self, product_id, fields=None):
        """获取商品详情"""
        # 公共参数
        params = {
            "app_key": self.app_key,
            "method": "com.alibaba.product:alibaba.product.get-1",
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
            "format": "json",
            "v": "2.0"
        }
        
        # 业务参数
        business_params = {
            "productId": product_id
        }
        
        if fields:
            business_params["fields"] = fields
        
        # 将业务参数转为JSON字符串并URL编码
        params["param_json"] = urllib.parse.quote(str(business_params).replace("'", "\""))
        
        # 生成签名
        params["sign"] = self._generate_sign(params)
        
        # 发送请求
        try:
            response = requests.get(self.base_url, params=params)
            response.raise_for_status()  # 抛出HTTP错误
            return response.json()
        except Exception as e:
            print(f"请求失败: {e}")
            return None

# 使用示例
if __name__ == "__main__":
    # 替换为实际的app_key和app_secret
    APP_KEY = "your_app_key"
    APP_SECRET = "your_app_secret"
    
    # 初始化API客户端
    api = Ali1688API(APP_KEY, APP_SECRET)
    
    # 商品ID
    product_id = "610551211999"
    
    # 需要返回的字段
    fields = "productId,title,priceRange,picUrl,minOrderQuantity"
    
    # 调用API获取商品详情
    result = api.get_product_details(product_id, fields)
    
    if result:
        print("商品详情:")
        print(result)