이벤트 API.

점수가 매겨진 여행,GPS 경로,HTTP로 대한 요인 수준 AURA 분석을 읽어보세요. 원격 측정은 SDK와 인증된 커넥터에 의해 에지에서 캡처됩니다. API 는 스택에 점수를 매기고 설명 가능한 결과를 제공합니다. AURA 는 언더라이팅을 지원합니다. 면허를 보유한 보험사는 가격 책정 권한을 유지합니다.

샌드박스 액세스 권한 얻기 SDK 보기

빠른 시작

인증한 다음 점수를 읽습니다.

모든 요청에는 전달자 토큰과 선택적 플릿 범위가 포함됩니다. 응답은 최상위 ok 플래그가 있는JSON입니다.

인증

Authorization 헤더에 전달자 토큰을 전달합니다. 선택적 x-fleet-id 헤더를 사용하여 하나의 플릿으로 요청 범위를 지정합니다. 이를 생략하면 관리 토큰은 자신이 소유한 모든 플릿을 볼 수 있습니다.

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.