爱回收开放平台估价接口实战：生产级调用与签名避坑（附完整 Python 代码）

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

class AiHuiShouAPI:
    """爱回收估价接口生产实现（含签名+异常+重试）"""
    def __init__(self, app_id: str, app_secret: str, sandbox: bool = True):
        self.app_id = app_id
        self.app_secret = app_secret.encode("utf-8")
        self.base_url = "https://sandbox.open.aihuishou.com" if sandbox else "https://open.aihuishou.com"
        self.timeout = 15
        self.retry = 2  # 自动重试

    def _generate_sign(self, params: Dict) -> str:
        """HMAC-SHA256签名（核心：参数ASCII排序+去空+拼接）"""
        # 1. 过滤空值与sign
        filtered = {k: v for k, v in params.items() if v is not None and v != "" and k != "sign"}
        # 2. 按键ASCII升序
        sorted_params = sorted(filtered.items(), key=lambda x: x[0])
        # 3. 拼接字符串
        sign_str = "".join([f"{k}{v}" for k, v in sorted_params])
        # 4. HMAC-SHA256
        sign = hmac.new(self.app_secret, sign_str.encode("utf-8"), hashlib.sha256).hexdigest().upper()
        return sign

    def estimate(self, category: str, brand: str, model: str, 
                 storage: str, appearance: str = "A", function: str = "normal") -> Dict:
        """设备估价接口"""
        url = f"{self.base_url}/api/v2/estimate"
        # 基础参数
        params = {
            "app_id": self.app_id,
            "timestamp": str(int(time.time())),
            "category": category,
            "brand": brand,
            "model": model,
            "storage": storage,
            "appearance": appearance,
            "function": function,
            "version": "2.0"
        }
        # 生成签名
        params["sign"] = self._generate_sign(params)

        for attempt in range(self.retry + 1):
            try:
                resp = requests.post(url, json=params, timeout=self.timeout)
                resp.raise_for_status()
                result = resp.json()

                # 标准化返回
                if result.get("code") == 200:
                    return {
                        "code": 200,
                        "msg": "success",
                        "data": {
                            "price": result["data"]["price"],
                            "price_desc": result["data"]["price_desc"],
                            "brand": brand,
                            "model": model,
                            "storage": storage,
                            "appearance": appearance
                        }
                    }
                # 常见错误
                elif result.get("code") == 401:
                    return {"code": 401, "msg": "签名失败/参数错误", "data": None}
                elif result.get("code") == 429:
                    return {"code": 429, "msg": "请求超限，1分钟后重试", "data": None}
                else:
                    return {"code": result.get("code"), "msg": result.get("msg", "未知错误"), "data": None}

            except Exception as e:
                if attempt == self.retry:
                    return {"code": 500, "msg": f"网络异常：{str(e)}", "data": None}
                time.sleep(1)

# 调用示例
if __name__ == "__main__":
    # 替换为平台申请的真实密钥
    APP_ID = "your_app_id"
    APP_SECRET = "your_app_secret"

    api = AiHuiShouAPI(APP_ID, APP_SECRET, sandbox=True)
    # 估价：iPhone 15 Pro 256GB 99新
    res = api.estimate(
        category="phone",
        brand="Apple",
        model="iPhone 15 Pro",
        storage="256GB",
        appearance="A"
    )
    print(json.dumps(res, ensure_ascii=False, indent=2))