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 後才開始生產計費。

常見問題