VVIC 平台商品详情接口深度开发：高可用签名与批发场景数据解析实战

import requests
import hashlib
import time
from typing import Dict, Optional

class VVICItemDetailClient:
    """VVIC商品详情接口标准化客户端（适配批发场景）"""
    def __init__(self, app_key: str, app_secret: str):
        self.app_key = app_key
        self.app_secret = app_secret
        self.base_url = "https://api.vvic.com/rest/item/detail"
        self.timeout = 10

    def _generate_sign(self, params: Dict[str, str]) -> str:
        """标准签名生成（官方规范）"""
        # 1. 过滤空值并按key升序
        sorted_items = sorted(
            [(k, v) for k, v in params.items() if v is not None and v != ""],
            key=lambda x: x[0]
        )
        # 2. 拼接参数
        param_str = "&".join([f"{k}={v}" for k, v in sorted_items])
        # 3. 追加密钥
        sign_raw = f"{param_str}{self.app_secret}"
        # 4. MD5大写
        sign = hashlib.md5(sign_raw.encode("utf-8")).hexdigest().upper()
        return sign

    def get_item_detail(self, item_id: str) -> Optional[Dict]:
        """获取商品详情（含批发价/SKU/档口）"""
        # 构造请求参数
        timestamp = str(int(time.time() * 1000))  # 13位毫秒
        params = {
            "app_key": self.app_key,
            "item_id": item_id,
            "timestamp": timestamp,
            "version": "1.0"
        }
        # 生成签名
        params["sign"] = self._generate_sign(params)

        try:
            # 发送请求（POST+JSON）
            resp = requests.post(
                self.base_url,
                json=params,
                headers={"Content-Type": "application/json"},
                timeout=self.timeout
            )
            resp.raise_for_status()
            result = resp.json()

            # 业务状态判断
            if result.get("code") == 200:
                return self._parse_wholesale_data(result["data"])
            else:
                print(f"API错误：{result.get('msg', '未知错误')}")
                return None

        except requests.exceptions.RequestException as e:
            print(f"请求异常：{str(e)}")
            return None

    def _parse_wholesale_data(self, data: Dict) -> Dict:
        """批发场景专属解析（提取核心字段）"""
        parsed = {
            "item_id": data.get("itemId"),
            "title": data.get("title"),
            "category": data.get("categoryPath", []),
            # 批发价格（区别于零售）
            "wholesale_price": {
                "mix_price": data.get("mixPrice"),   # 混批价
                "package_price": data.get("packagePrice"), # 打包价
                "min_buy": data.get("minBuy")       # 起批量
            },
            # SKU规格+库存（服装多尺码/颜色）
            "skus": [{
                "sku_id": sku.get("skuId"),
                "specs": sku.get("specs", {}),
                "price": sku.get("price"),
                "stock": sku.get("stock")
            } for sku in data.get("skus", [])],
            # 档口信息（B2B核心）
            "shop": {
                "shop_name": data.get("shopName"),
                "market": data.get("marketName"),  # 如十三行、四季青
                "score": data.get("shopScore")
            },
            "images": data.get("mainImages", [])
        }
        return parsed

# ———— 调用示例 ————
if __name__ == "__main__":
    # 替换为你的密钥
    APP_KEY = "your_app_key"
    APP_SECRET = "your_app_secret"
    ITEM_ID = "12345678"  # 商品ID

    client = VVICItemDetailClient(APP_KEY, APP_SECRET)
    detail = client.get_item_detail(ITEM_ID)
    if detail:
        import json
        print(json.dumps(detail, ensure_ascii=False, indent=2))