Fleet API Webhook

개요

Fleet API Webhook은 실시간으로 발생하는 차량의 데이터를 고객이 원하는 Endpoint로 수신할 수 있도록 하는 기능입니다. Fleet API Webhook을 처음 접하시는 분은 먼저 Fleet API Webhook Overview 문서를 참고하세요.

지원하는 Webhook Event

Webhook Event Type	Description
주기 데이터(Periodic data)	차량에서 주기적으로 발생하는 차량 데이터의 스냅샷 제공
차량 이벤트 데이터(Vehicle event)	차량에서 문열림 등의 이벤트 발생 시 이벤트 정보 제공

지원하는 Webhook event type별 상세한 Schema는 각 문서를 참고하시기 바랍니다.

ValueObject

차량 데이터는 ValueObject<T> 형태로 구성되며, ValueObject의 Schema는 다음과 같습니다.

Schema

Key Name	Description	Value Type	Sample Value
value	ValueObject가 가진 Value의 값	T	123
eventTime	Value가 발생한 시간 (ISO 8601)	String	2025-02-12T08:12:58.628000000Z

Example

ValueObject<Double> (ex. Speed)

{
  "value": 33.0,
  "eventTime": "2025-02-12T08:12:58.628000000Z"
}

ValueObject<String> (ex. Charging status)

{
  "value": "ACTIVE",
  "eventTime": "2025-02-12T08:12:58.628000000Z"
}