Developer Ecosystem
SyncVelo で、モビリティの未来を構築する
フリートのデバイス、位置、走行、アラート、レポート、ドライバーのための、オープンで安全なバージョン管理インターフェース。署名付き Webhook、TypeScript SDK、サンドボックス付き。
- REST & OpenAPI
- 署名付き Webhook
- TypeScript SDK
- シミュレーション車両のサンドボックス
1const api = 'https://api.syncvelo.com';2const { SYNCVELO_CLIENT_ID: id, SYNCVELO_CLIENT_SECRET: secret, SYNCVELO_ORG: org } = process.env;3 4const { access_token } = await fetch(`${api}/oauth/token`, {5 method: 'POST',6 headers: { Authorization: `Basic ${btoa(`${id}:${secret}`)}` },7 body: new URLSearchParams({ grant_type: 'client_credentials' }),8}).then((r) => r.json());9 10// Cursor pagination: follow next_cursor until it is null11let cursor: string | null = null;12do {13 const url = new URL(`${api}/v1/tenants/${org}/devices?limit=100`);14 if (cursor) url.searchParams.set('cursor', cursor);15 const page = await fetch(url, { headers: { Authorization: `Bearer ${access_token}` } }).then((r) => r.json());16 for (const d of page.items) console.log(d.id, d.status, d.latitude, d.longitude, d.speed_kph);17 cursor = page.next_cursor;18} while (cursor);接続手段
あらゆる接続方法に、管理機能を標準搭載
どの接続手段も、認可、テナント管理、監査可能性を最初から前提に設計されています。
公開 REST & OpenAPI
デバイス、位置、走行、ジオフェンス、ルール、アラート、レポート、ドライバー。カーソル方式のページネーションと明示的なバージョン付き。
管理機能: OAuth2 クライアントクレデンシャル、スコープ、レート制限、1 日のクォータ。
イベント Webhook
アラート、ジオフェンスの出入り、完了した走行を、署名付きで配信し、間隔を空けて再試行し、再送もできます。
管理機能: イベントを失わないシークレットのローテーション。クライアントは 1 組織に限定。
TypeScript SDK
OpenAPI 文書から生成した型付きクライアント。カーソルを自動でたどり、安全な場合にだけ再試行します。
管理機能: セマンティックバージョニングと互換性テスト。
サンドボックス
シミュレーション車両、サンプルの走行、テスト用 Webhook を備えた独立した組織。必要に応じてリセットできます。
管理機能: ルートで分離：親組織はなく、実データにはアクセスできません。
コンソールの開発者ページ
API クライアント、スコープ、Webhook エンドポイントを組織のオーナーが管理。API リファレンス付き。
管理機能: シークレットは一度だけ表示し、フィンガープリントとしてのみ保存。
データ転送と MQTT
他のプラットフォームや官公庁サーバーへの転送、インテグレーター向け MQTT。計画中（X5）。
管理機能: 現在は利用できません。
REST & OpenAPI
テナントを尊重する、予測可能な API
カーソルページネーション、フィルター、冪等キー、明示的なバージョンを備えたリソース指向のエンドポイント。すべてのリクエストに完全なテナントポリシーが適用されます。
- きめ細かなスコープを備えた OAuth2 クライアントクレデンシャル
- 内部エンジンのキーではなく、SyncVelo の正規 ID を使用
- 書き込み時の冪等キーと安全なリトライ
- クライアントごとのレート制限と 1 日のクォータ
1const api = 'https://api.syncvelo.com';2const { SYNCVELO_CLIENT_ID: id, SYNCVELO_CLIENT_SECRET: secret, SYNCVELO_ORG: org } = process.env;3 4const { access_token } = await fetch(`${api}/oauth/token`, {5 method: 'POST',6 headers: { Authorization: `Basic ${btoa(`${id}:${secret}`)}` },7 body: new URLSearchParams({ grant_type: 'client_credentials' }),8}).then((r) => r.json());9 10// Cursor pagination: follow next_cursor until it is null11let cursor: string | null = null;12do {13 const url = new URL(`${api}/v1/tenants/${org}/devices?limit=100`);14 if (cursor) url.searchParams.set('cursor', cursor);15 const page = await fetch(url, { headers: { Authorization: `Bearer ${access_token}` } }).then((r) => r.json());16 for (const d of page.items) console.log(d.id, d.status, d.latitude, d.longitude, d.speed_kph);17 cursor = page.next_cursor;18} while (cursor);Webhook
リアルタイムのイベントを、確実に配信
アラート（発生、解消、確認、クローズ）、ジオフェンスの出入り、完了した走行を購読できます。すべての配信は署名付きで、間隔を空けて再試行され、30 日間は再送できます。
- タイムスタンプの許容範囲付き、HMAC 署名ペイロード
- 自動リトライ、デッドレターキュー、リプレイ
- OpenAPI 文書にバージョン付きのイベントカタログ
- コンソールと API で見られる配信ログ
1POST /your/webhook2webhook-id: 6f0c2d2e-1b55-8a4e-9c3f-8f9a2b7d1e403webhook-timestamp: 17923164674webhook-signature: v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=5 6{7 "id": "6f0c2d2e-1b55-8a4e-9c3f-8f9a2b7d1e40",8 "type": "geofence.exited",9 "schema_version": "1.0",10 "organization_id": "1f7c…",11 "occurred_at": "2026-10-19T09:41:07.000Z",12 "created_at": "2026-10-19T09:41:08.214Z",13 "data": { "device_id": "8d2a…", "geofence_id": "c41e…" }14}SDK
型付きの TypeScript クライアントと、それ以外はシンプルな REST で
TypeScript SDK は OpenAPI 文書から生成し、サンドボックスへのアクセスとともに提供しています。公開レジストリにはまだ載せていません。ほかの言語からは REST API を直接呼び出します。
TypeScript
サーバー向け：Node.js 20 以降、Deno、Bun、エッジランタイム。型付きメソッド、カーソルの自動追跡、安全な再試行、Webhook の検証。
import { SyncVelo } from '@syncvelo/sdk'その他の言語
Python、Java、Go など HTTPS を扱える言語なら、上のサンプルのように REST API と OpenAPI 文書を使えます。
GET https://api.syncvelo.com/openapi.json
連携のライフサイクル
最初の API キーから本番運用まで、一貫したガバナンスで
- 01
登録
オーナーがコンソールの開発者ページで、必要なスコープだけを持つ API クライアントを作成します。
- 02
認可
クライアントは ID とシークレットを短期間有効なアクセストークンに交換します（OAuth2 クライアントクレデンシャル）。
- 03
購読
Webhook エンドポイントを登録し、テストイベントを送り、まずはサンドボックスで試せます。
- 04
運用
すべてのリクエストにクォータ、冪等性、リトライ、完全なテナントポリシーを適用します。
- 05
監視
配信ログ、失敗した配信の再送、シークレットのローテーションと失効。
開発者サンドボックス
今日から開発を始めましょう
シミュレーションデバイス、サンプルのトリップ、テスト用 Webhook を備えたサンドボックステナントをご利用いただけます。開発者向けアクセスは現在、パイロットパートナーとインテグレーターに提供しています。
このページのコードサンプルは説明用です。完全な API リファレンスは、サンドボックスへのアクセスとともに提供されます。
はじめる
あなたの世界を、もっとスマートに動かしませんか？
SyncVelo がお客様のフリート、パートナービジネス、次のインテグレーションをどう支えるのかをご覧ください。実機デバイスを使い、お客様のユースケースに合わせて担当者が個別にご案内します。