API アクセス

EV Manual データを診断機器、整備工場管理システム、EC サイトに統合してください。パートナー向けサービスは 3 形態——お使いの製品に合うものをお選びください：

データドメイン

API は 4 つのデータドメイン——VIN デコード、パラメータシート、整備マニュアル、配線図＆DTC 検索——を公開し、すべてのレスポンスに Web インターフェースと同じ一致レベルのメタデータが含まれます。そのため、統合側は追加ロジックなしでエンドユーザーに信頼度情報を提示できます。

認証と課金

すべてのリクエストは API キーペアと HMAC-SHA256 署名で認証され、署名はタイムスタンプとリクエストボディをカバーするため、リプレイ攻撃や未承認利用を防げます。課金は従量制です。呼び出しは計量されトークン残高から差し引かれ、利用量ティアに応じて単価が自動的に下がります。

• すべてのパートナーに API キーペアが発行され、リクエストには HMAC-SHA256 署名とタイムスタンプが付きます。
• 従量課金：呼び出しは計量されトークン残高から差し引かれ、利用量ティアで単価が下がります。
• レート制限はティアに応じて拡張されるため、整備中に診断ツールがポーリングしても停止しません。
• SLA：API バックエンドは公開静的サイトとは独立した専用 VPS で稼働しています。

統合ガイド

典型的な統合には 1〜5 営業日かかります：無料アカウントを登録し、パートナーシップページからテストクレデンシャルを申請し、既知の VIN でサンドボックスエンドポイントを呼んで署名フローを検証します。例えば 2019 年式 Toyota Camry の VIN をデコードすると、車型バージョン、8 文字の VIN プレフィックス、パラメータシートへのリンクが 1 つの JSON レスポンスで返ります。

1. /shop/register.html で無料アカウントに登録——これが課金 ID になります。
2. パートナーシップ経由でクレデンシャルを申請。テストキーは 1 営業日以内に発行されます。
3. timestamp + method + path + body で HMAC-SHA256 リクエスト署名。Python と JavaScript のリファレンス署名実装を提供しています。
4. サンドボックスのベース URL を入れ替えるだけで本番稼働。利用量は Web ショップと同じトークンウォレットに計量されます。

多くのパートナーは 3 つのリファレンス VIN——完全一致 1 件、WMI フォールバック 1 件、ブランドレベル候補 1 件——で統合を検証します。これら 3 ケースがデコーダーが取り得るすべてのコードパスを網羅するためです。

活用例

現在の統合例：スキャン前に VIN をデコードする欧州の診断ツールメーカー、出品を車型バージョンに紐付ける部品マーケットプレイス、ホワイトラベル CNAME で完全なデータセンターを運用するディーラーグループ。いずれの場合も統合面は同一で、課金プロファイルだけが異なります。データの鮮度も公開サイトと同じで、API レスポンスは 2026-10-15 に更新された同一データセットから提供されるためです。

• 診断ツール —— まず車両を特定し、車型専用の DTC 定義と配線図を読み込みます。
• 部品 EC —— 顧客の VIN を正確な車型バージョンにマッピングし、誤部品の返品をゼロにします。
• ディーラーポータル —— ホワイトラベルの工場ドキュメントでサービス顧客をディーラーサイトに留めます。

サンドボックスとテスト

すべての統合は無料サンドボックスから始まります。サンドボックスは本番と同じデータ構造を持ちながら固定のリファレンス VIN セットで応答するため、1 トークンも消費せずに構築とテストが可能です。また、サンドボックスは本番と同じ一致レベルのメタデータを返すため、信頼度表示ロジックを本番移行前に実際のフォールバック事例でテストできます。

• 無料テストキー —— パートナーシップ経由で 1 営業日以内に発行。契約や利用量コミットメントは不要です。
• リファレンス VIN —— 完全一致、WMI フォールバック、ブランドレベル候補を各レベル 1 件ずつカバーする文書化済みセット。
• リファレンス署名実装 —— Python／JavaScript のコピペ可能な HMAC-SHA256 署名サンプルに加え、Postman コレクションを提供。
• ゼロコストのテスト —— サンドボックスの呼び出しは一切計量されません。ベース URL を入れ替えた時点で本番課金が開始されます。

よくある質問