Periodic Data

주의

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-42dot-transmissionType	수집/전송 주기 정보	String	10S_30S
X-Custom-Key	(Optional) 사용자가 Webhook 등록 시 등록한 Custom Header	String	My custom value

Payload Schema

Key	Description	Type	Sample value	수집/전송 주기(s)
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.Latitude	위도	ValueObject<Double>		10 / 30
items[].data.Vehicle.Longitude	경도	ValueObject<Double>		10 / 30
items[].data.Vehicle.Speed	차량 속도 (km/h)	ValueObject<Double>		10 / 30
items[].data.Vehicle.Odometer	누적주행거리 (km)	ValueObject<Double>		10 / 30
items[].data.AuxiliaryBattery.Voltage	12V 배터리 전압(Volt)	ValueObject<Double>		10 / 30
items[].data.Vehicle.Tire.Pressure.FrontLeft	타이어 공기압 FL	ValueObject<Double>		10 / 30
items[].data.Vehicle.Tire.Pressure.FrontRight	타이어 공기압 FR	ValueObject<Double>		10 / 30
items[].data.Vehicle.Tire.Pressure.RearLeft	타이어 공기압 RL	ValueObject<Double>		10 / 30
items[].data.Vehicle.Tire.Pressure.RearRight	타이어 공기압 RR	ValueObject<Double>		10 / 30
items[].data.ChargeSystem.Active	충전 상태	ValueObject<String>	[ "ACTIVE", "INACTIVE" ]	10 / 30
items[].data.TractionBattery.SOC	배터리 SOC(%)	ValueObject<Double>		10 / 30
items[].data.Vehicle.DTE	주행가능거리(km)	ValueObject<Double>		10 / 30
items[].data.TractionBattery.RegenerativeEnergy	재생회동 충전량(kWh)	ValueObject<Double>		10 / 30

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": {
          "Speed": {
            "value": 33.0,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          },
          "Odometer": {
            "value": 85488.20000000001,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          },
          "Longitude": {
            "value": -154.91031883652636,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          },
          "Latitude": {
            "value": -18.69372709987225,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          }
        }
      }
    },
    {
      "messageTime": "2025-02-12T08:12:48.529000000Z",
      "data": {
        "Vehicle": {
          "Speed": {
            "value": 33.0,
            "eventTime": "2025-02-12T08:12:48.529000000Z"
          },
          "Odometer": {
            "value": 85488.20000000001,
            "eventTime": "2025-02-12T08:12:48.529000000Z"
          },
          "Longitude": {
            "value": -19.375769325931543,
            "eventTime": "2025-02-12T08:12:48.529000000Z"
          },
          "Latitude": {
            "value": -76.1095325617343,
            "eventTime": "2025-02-12T08:12:48.529000000Z"
          }
        }
      }
    },
    {
      "messageTime": "2025-02-12T08:12:38.433000000Z",
      "data": {
        "Vehicle": {
          "Speed": {
            "value": 33.0,
            "eventTime": "2025-02-12T08:12:38.433000000Z"
          },
          "Odometer": {
            "value": 85488.20000000001,
            "eventTime": "2025-02-12T08:12:38.433000000Z"
          },
          "Longitude": {
            "value": -14.687766053318,
            "eventTime": "2025-02-12T08:12:38.433000000Z"
          },
          "Latitude": {
            "value": 0.07465427590453544,
            "eventTime": "2025-02-12T08:12:38.433000000Z"
          }
        }
      }
    }
  ]
}

Payload example 2

{
  "vin": "HMGSDV00000000001",
  "vehicleId": "e79049fb-e744-11ef-8dd9-f56aaa011ede",
  "itemsCount": 1,
  "items": [
    {
      "messageTime": "2025-02-12T08:12:58.628000000Z",
      "data": {
        "Tire": {
          "Pressure": {
            "FrontLeft": {
              "value": 37.0,
              "eventTime": "2025-02-12T08:12:58.628000000Z"
            },
            "RearRight": {
              "value": 37.0,
              "eventTime": "2025-02-12T08:12:58.628000000Z"
            },
            "RearLeft": {
              "value": 37.0,
              "eventTime": "2025-02-12T08:12:58.628000000Z"
            },
            "FrontRight": {
              "value": 37.0,
              "eventTime": "2025-02-12T08:12:58.628000000Z"
            }
          }
        },
        "AuxiliaryBattery": {
          "Voltage": {
            "value": 14.685,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          }
        },
        "Acceleration": {
          "Longitudinal": {
            "value": -0.023326094999999825,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          },
          "Lateral": {
            "value": 0.025875394999999912,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          }
        }
      }
    }
  ]
}

Payload example 3

{
  "vin": "HMGSDV00000000001",
  "vehicleId": "e79049fb-e744-11ef-8dd9-f56aaa011ede",
  "itemsCount": 1,
  "items": [
    {
      "messageTime": "2025-02-12T08:12:58.628000000Z",
      "data": {
        "ChargeSystem": {
          "Active": {
            "value": "INACTIVE",
            "eventTime": "2024-12-12T08:24:09.107000000Z"
          }
        },
        "Vehicle": {
          "DTE": {
            "value": 412.0,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          }
        },
        "TractionBattery": {
          "SOC": {
            "value": 95.0,
            "eventTime": "2025-02-12T08:12:58.628000000Z"
          }
        }
      }
    }
  ]
}