签名算法、参数构造与响应体解析：解密 1688 商品详情接口

import requests
import time
import hashlib
import json
from urllib.parse import urlencode

class AlibabaProductApi:
    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/1/com.alibaba.product/"
    
    def generate_sign(self, params):
        """生成签名"""
        # 1. 按参数名ASCII码升序排序
        sorted_params = sorted(params.items(), key=lambda x: x[0])
        
        # 2. 拼接为"key=value&key=value"形式
        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_system_params(self, method):
        """获取系统级参数"""
        return {
            "app_key": self.app_key,
            "method": method,
            "format": "json",
            "v": "1.0",
            "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()),
            "sign_method": "md5"
        }
    
    def get_product_detail(self, product_id):
        """获取商品详情"""
        # 接口方法名
        method = "alibaba.product.get"
        
        # 构造系统参数
        system_params = self.get_system_params(method)
        
        # 构造业务参数
        business_params = {
            "productId": product_id,
            "fields": "productId,title,price,rprice,minimumOrderQuantity,detailUrl"
        }
        system_params["param_json"] = json.dumps(business_params)
        
        # 生成签名
        sign = self.generate_sign(system_params)
        system_params["sign"] = sign
        
        # 构造完整URL
        url = f"{self.base_url}{method.replace('.', '/')}/"
        
        try:
            # 发送请求
            response = requests.get(url, params=system_params, timeout=10)
            response.raise_for_status()  # 抛出HTTP错误
            
            # 解析响应
            result = response.json()
            
            # 检查接口调用是否成功
            if "error_response" in result:
                error = result["error_response"]
                print(f"接口调用失败: {error['msg']} (错误码: {error['code']})")
                return None
            
            # 返回商品详情数据
            return result["alibaba_product_get_response"]["product"]
            
        except requests.exceptions.RequestException as e:
            print(f"请求发生错误: {str(e)}")
            return None
        except json.JSONDecodeError:
            print("响应解析失败，不是有效的JSON格式")
            return None
        except KeyError as e:
            print(f"响应结构异常，缺少字段: {str(e)}")
            return None

# 使用示例
if __name__ == "__main__":
    # 替换为实际的App Key和App Secret
    APP_KEY = "your_app_key"
    APP_SECRET = "your_app_secret"
    
    # 初始化API客户端
    api = AlibabaProductApi(APP_KEY, APP_SECRET)
    
    # 获取商品详情（替换为实际的商品ID）
    product_id = "61055555555"
    product_detail = api.get_product_detail(product_id)
    
    if product_detail:
        print("商品详情获取成功：")
        print(f"商品ID: {product_detail.get('productId')}")
        print(f"商品标题: {product_detail.get('title')}")
        print(f"价格: {product_detail.get('price')}")
        print(f"起订量: {product_detail.get('minimumOrderQuantity')}")
        print(f"详情页URL: {product_detail.get('detailUrl')}")