イベント API。

スコア付き走行データ、GPSルート、およびHTTPに対する要因レベルの AURA の内訳を読み取ります。テレメトリは、 SDK および認定コネクタによってエッジでキャプチャされます。 API はスタックにスコア付きの説明可能な結果を与えます。 AURAは引受業務をサポートしています。ライセンスを取得した保険会社が価格設定の権限を保持します。

サンドボックスへのアクセスを取得する SDK を見る

クイックスタート

認証してからスコアを読み取ります。

すべてのリクエストにはベアラートークンとオプションのフリートスコープが含まれます。応答はトップレベルの ok フラグを伴うJSONです。

認証

Authorization ヘッダーでベアラートークンを渡します。オプションの x-fleet-id ヘッダーを使用して、リクエストの範囲を 1 つのフリートに設定します。これを省略すると、管理者トークンは自分が所有するすべてのフリートを参照します。

cURL · authenticated request

curl https://api.yas.dev/v1/trips \
  -H "Authorization: Bearer $YAS_TOKEN" \
  -H "x-fleet-id: fleet_joie"

# Base URL
# Sandbox  https://api.sandbox.yas.dev/v1
# Productionhttps://api.yas.dev/v1

200 OK · application/json

{
  "ok": true,
  "trips": [
    { "tripId": "trip_2026_0142", "overallScore": 72.4, "tier": "Good" }
  ],
  "pagination": { "page": 1, "limit": 20, "totalPages": 9, "total": 172 }
}

参考資料

コアエンドポイント。

旅行、ルート、スコア、車両の読み取り専用エンドポイント。取り込みは、パブリック書き込みエンドポイントではなく、 SDK とコネクタを通じて行われます。

GET/v1/tripsBearer
List scored trips, newest first, with pagination and fleet scope.
GET/v1/trips/{id}Bearer
Retrieve a single trip with its summary metrics and GPS link.
GET/v1/trips/{id}/score-breakdownBearer
Theme-by-factor AURA score breakdown for one trip.
GET/v1/vehicles/{plate}Bearer
Vehicle risk profile and driver roster.

例

トリップスコアの内訳を取得します。

この内訳では、約 100 のリスク要因が 6 つのテーマにグループ化されており、それぞれに独自のサブスコアがあり、最も弱いテーマに名前が付けられているため、どこを指導すればよいかがわかります。

GET /v1/trips/{id}/score-breakdown

{
  "ok": true,
  "breakdown": {
    "tripId": "trip_2026_0142",
    "overallScore": 72.4,
    "mapMatched": true,
    "themes": [
      {
        "id": "speeding", "label": "Speeding",
        "themeScore": 68.2,
        "factors": [
          { "key": "speedingIntensity", "score": 71.5 }
        ]
      }
    ],
    "weakestTheme": { "id": "speeding", "label": "Speeding" }
  }
}

データモデル

旅行オブジェクト。

トリップはスコアリングの単位です。これらは、ほとんどの統合で読み取られるフィールドです。完全なスキーマはリファレンスドキュメントにあります。

フィールド	種類	説明
`tripId`	`string`	Stable identifier for the trip.
`overallScore`	`number`	AURA score for the trip, 0–100. Higher is safer.
`tier`	`string`	Derived band: Critical (<45), Fair (<65), Good (<80), Safe.
`mapMatched`	`boolean`	Whether the trip was map-matched to the road network.
`distanceKm`	`number`	Trip distance in kilometres.
`durationMin`	`number`	Trip duration in minutes.
`startDate`	`string`	ISO 8601 start timestamp.
`vehicle`	`string`	Vehicle plate or unit identifier.