API 接入

把 EV Manual 数据集成到诊断设备、维修厂管理系统或电商平台。合作服务提供三种形态——选择适合您产品的一种：

数据域

API 暴露四个数据域——VIN 解码、参数表、维修手册，以及线路图与 DTC 查询——每个响应都包含与网页界面相同的匹配级别元数据。因此集成方无需额外逻辑即可向最终用户展示置信度信息。

鉴权与计费

每个请求都通过 API 密钥对和 HMAC-SHA256 签名鉴权，签名覆盖时间戳与请求体，可防止重放攻击和未授权使用。计费按量：调用被计量并从 Token 余额中扣除，用量阶梯随规模增长自动降低单价。

• 每个合作伙伴都会获得 API 密钥对；请求使用 HMAC-SHA256 签名并附时间戳。
• 按量计费：调用被计量并从 Token 余额扣除；用量阶梯降低单价。
• 速率限制随等级扩展，诊断工具在维修过程中轮询永不停顿。
• SLA：API 后端运行在独立 VPS 上，与公开静态站点隔离。

集成指南

典型集成需要 1 到 5 个工作日：注册免费账号，从合作页面申请测试凭据，然后用一个已知 VIN 调用沙箱端点验证签名流程。例如，解码一个 2019 款 Toyota Camry 的 VIN，会在单个 JSON 响应中返回车型版本、其 8 位 VIN 前缀以及参数表链接。

1. 在 /shop/register.html 注册免费账号——这将成为您的计费身份。
2. 通过 合作页面申请凭据；测试密钥在一个工作日内签发。
3. 用 timestamp + method + path + body 进行 HMAC-SHA256 请求签名；提供 Python 和 JavaScript 参考签名实现。
4. 替换沙箱基础 URL 即可上线；用量计量到与网页商城同一个 Token 钱包。

多数合作伙伴用三个参考 VIN 验证集成——一个精确前缀匹配、一个 WMI 回退和一个品牌级候选——因为这三个用例覆盖了解码器所有可能的代码路径。

典型用例

现有集成包括：一家在扫描前先解码 VIN 的欧洲诊断设备厂商、一个将配件列表匹配到车型版本的配件市场平台，以及一家以白标 CNAME 运行完整资料中心的经销商集团。三者的集成界面完全相同——只有计费档位不同。三者的数据新鲜度与公开站点一致，因为 API 响应与 2026-10-15 更新的同一数据集同源。

• 诊断工具 —— 先识别车辆，再加载车型专属的 DTC 定义与线路图。
• 配件电商 —— 将客户 VIN 映射到具体车型版本，消除错件退货。
• 经销商门户 —— 以白标维修文档让客户留在经销商网站。

沙箱与测试

每次集成都从免费沙箱开始：沙箱镜像生产环境的数据结构，但仅返回固定的参考 VIN 集合，因此您可以零 Token 消耗地构建与测试。此外，沙箱返回与生产相同的匹配级别元数据，意味着您的置信度展示逻辑在上线前就已针对真实回退场景测试过。

• 免费测试密钥 —— 通过 合作页面在一个工作日内签发；无需合同或用量承诺。
• 参考 VIN —— 文档化的集合，覆盖精确前缀匹配、WMI 回退与品牌级候选，每种匹配级别一个。
• 参考签名实现 —— Python 与 JavaScript 的 HMAC-SHA256 签名复制示例，外加 Postman 冒烟测试集合。
• 零成本测试 —— 沙箱调用永不计量；替换基础 URL 后才开始生产计费。

常见问题