1688 商品详情 API 接口全解析（调用、字段、异常、实战）

import requestsimport hashlibimport time# 配置项（替换为自己的）APP_KEY = "你的App Key"APP_SECRET = "你的App Secret"API_URL = "https://gw.api.1688.com/openapi/param2/1/alibaba.item.get/2.0"def generate_sign(params):
    """生成1688 API签名（核心）"""
    # 1. 按ASCII升序排序，过滤空值
    sorted_params = sorted([(k, v) for k, v in params.items() if v], key=lambda x: x[0])
    # 2. 拼接+加密
    sign_str = APP_SECRET + "".join([f"{k}{v}" for k, v in sorted_params]) + APP_SECRET    return hashlib.md5(sign_str.encode()).hexdigest().upper()def get_1688_item_detail(item_id):
    """调用商品详情接口"""
    # 构造参数
    params = {
        "app_key": APP_KEY,
        "method": "alibaba.item.get",
        "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
        "format": "json",
        "v": "2.0",
        "sign_method": "md5",
        "item_id": item_id,
        "fields": "item_id,title,price,min_order_quantity,supplier_info,sku_list"
    }
    # 生成签名
    params["sign"] = generate_sign(params)
    
    # 发起请求
    try:
        resp = requests.get(API_URL, params=params, timeout=10)
        resp.encoding = "utf-8"
        result = resp.json()
        
        # 处理结果
        if result["code"] != 0:
            raise Exception(f"调用失败：{result['data']['error_response']['msg']}")
        return result["data"]["item_get_response"]["item"]
    except Exception as e:
        print(f"异常：{e}")
        return None# 调用示例if __name__ == "__main__":
    item_data = get_1688_item_detail("689712345678")  # 替换为目标商品ID
    if item_data:
        print(f"商品标题：{item_data['title']}")
        print(f"批发价：{item_data['price']} 元，起批量：{item_data['min_order_quantity']} 件")