Vehicle event

주의

items[] 내부의 차량 데이터는 수신된 경우에만 응답에 포함되는 Optional 값입니다.

Request Info

• Protocol : HTTPS (Mandatory)
• Method : POST

Request Header

요청 헤더에 아래의 값이 포함됩니다.

Key	Description	Type	(Sample) Value
Content-Type	Content Type	String	application/json; charset=utf-8
X-API-Version	Fleet API의 버전	String	v1.0
X-Custom-Key	(Optional) 사용자가 Webhook 등록 시 등록한 Custom Header	String	My custom value

Payload Schema

Key	Description	Type	Sample value
vin	차량 고유 식별 번호	String	HMGSDV00000000001
vehicleId	차량 고유 ID	String	e79049fb-e744-11ef-8dd9-f56aaa011ede
itemsCount	items의 개수	Integer	3
items	차량 데이터 배열	Object Array
items[].messageTime	차량 데이터가 기록된 시간 (ISO 8601)	String	2025-02-12T08:12:58.628000000Z
items[].data	차량 데이터 객체	Object
items[].data.Vehicle.Ignition1	시동 - IG1	ValueObject<String>	[ "OFF", "ON" ]
items[].data.Vehicle.Ignition2	시동 - IG2	ValueObject<String>	[ "OFF", "ON" ]
items[].data.Vehicle.Ignition3	시동 - IG3	ValueObject<String>	[ "OFF", "ON" ]
items[].data.Vehicle.IgnitionAcc	시동 - ACC	ValueObject<String>	[ "OFF", "ON" ]
items[].data.Vehicle.DrivingReady	시동 - ON	ValueObject<String>	[ "OFF", "ON" ]
items[].data.Door.Open.Driver	도어 개폐 상태 운전석	ValueObject<String>	[ "CLOSE", "OPEN" ]
items[].data.Door.Lock.Driver	도어 잠금 상태 운전석	ValueObject<String>	[ "LOCK", "UNLOCK" ]
items[].data.Hood.Open	후드 개폐 상태	ValueObject<String>	[ "CLOSE", "OPEN" ]
items[].data.Trunk.Open	트렁크 개폐 상태	ValueObject<String>	[ "CLOSE", "OPEN" ]
items[].data.ChargePort.Plug	충전기 연결 상태	ValueObject<String>	[ "PLUG", "UNPLUG" ]
items[].data.Emergency.Crash	충격 상태	ValueObject<String>	[ "CRASH", "UNCRASH" ]
items[].data.Seat.Buckle.Driver	운전석 안전벨트 상태	ValueObject<String>	[ "BUCKLE", "UNBUCKLE" ]
items[].data.Seat.Buckle.Passenger	보조석 안전벨트 상태	ValueObject<String>	[ "BUCKLE", "UNBUCKLE" ]
items[].data.ParkingBrake.Engage	주차 브레이크	ValueObject<String>	[ "DISENGAGE", "ENGAGE" ]
items[].data.WarningLamp.Airbag	에어백 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.EBD	EBD 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.ABS	ABS경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.EPS	EPS 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.ChargingSystem	충전시스템 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.TirePressure.FrontLeft	타이어 공기압 - 1열 좌측	ValueObject<String>	[ "LOW", "NORMAL" ]
items[].data.WarningLamp.TirePressure.FrontRight	타이어 공기압 - 1열 우측	ValueObject<String>	[ "LOW", "NORMAL" ]
items[].data.WarningLamp.TirePressure.RearLeft	타이어 공기압 - 2열 좌측	ValueObject<String>	[ "LOW", "NORMAL" ]
items[].data.WarningLamp.TirePressure.RearRight	타이어 공기압 - 2열 우측	ValueObject<String>	[ "LOW", "NORMAL" ]
items[].data.WarningLamp.HeadLamp	LED해드램프 경고등	ValueObject<String>	[ "DEFECT", "NORMAL" ]
items[].data.WarningLamp.EPB	EBP 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.ESC	ESC경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.RegenerativeBrake	회생제동 브레이크 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.TractionBatterySOC	구동배터리저전압 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.EVPowerDown	파워다운 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.EVService	전기차 서비스 경고등	ValueObject<String>	[ "BLINK", "OFF", "ON" ]
items[].data.WarningLamp.WasherFluid	워셔액 부족 경고등	ValueObject<String>	[ "LOW", "NORMAL" ]
items[].data.WarningLamp.BrakeOil	브레이크 오일 경고등	ValueObject<String>	[ "LOW", "NORMAL" ]
items[].data.WarningLamp.AuxiliaryBatterySOC	12V 배터리 부족	ValueObject<String>	[ "LOW", "NORMAL" ]

Payload examples

Payload example 1

{
  "vin": "HMGSDV00000000001",
  "vehicleId": "e79049fb-e744-11ef-8dd9-f56aaa011ede",
  "itemsCount": 3,
  "items": [
    {
      "messageTime": "2025-02-12T08:12:58.628000000Z",
      "data": {
        "Vehicle": {
          "Seat": {
            "Buckle": {
              "Driver": {
                "value": false,
                "eventTime": "2025-01-31T01:17:40.702000000Z"
              }
            }
          }
        }
      }
    }
  ]
}