Vehicle Data API
Vehicle Data API는 차량 데이터를 조회하는 오픈 API입니다. 현대/기아/제네시스 커넥티드 카에서 생성되는 텔레매틱스 데이터를, 데이터 공유에 동의한 범위 내에서 안전하게 제공합니다.
이 API는 사용자의 차량 데이터를 보호하면서 안전하고 책임 있는 데이터 공유를 지원합니다. 이를 통해 사용자는 차량에서 생성된 데이터에 접근하고, 데이터 공유를 승인한 제3자에게 차량 데이터를 제공할 수 있습니다.
사용자 유형
Vehicle Data API는 다음 두 유형의 사용자를 지원합니다.
| 유형 | 시작 가이드 |
|---|---|
| Private Users | For Private Users |
| Business Users | For Business Users |
제공 데이터
Vehicle Data API는 차량 상태 정보(Vehicle status information)와 차량 기초 데이터(Vehicle basic data)를 제공합니다.
-
차량 상태 정보
- 충전 상태, 파워트레인 상태, 차량 위치, 운행 상태, 센서 기반 상태, 공조 상태 등이 포함됩니다.
- Business Users: 차량 소유자로부터 데이터 공유 동의를 얻은 직후 바로 조회할 수 있습니다.
- Private Users: 본인의 차량이므로 데이터 공유 동의 없이 API 키 획득 이후로 바로 조회할 수 있습니다.
-
차량 기초 데이터
- 파워트레인 기초 데이터, 속도 관련 기초 데이터, 운행 관련 기초 데이터, 차량 센서 기반 기초 데이터가 포함됩니다.
- Business Users: 차량 소유자로부터 데이터 공유 동의를 얻은 뒤 24시간이 지난 다음부터 조회할 수 있습니다.
- Private Users: 본인의 차량이므로 데이터 공유 동의 없이 API 키 획득 이후로 바로 조회할 수 있습니다.
차종·모델별 제공 데이터는 API Compatibility를 참조합니다.
Vehicle Data API 목록
| API | Endpoint URL | Description |
|---|---|---|
| Get Battery Charging Status | https://api.pleos.ai/v1/vehicles/{vin}/batteries | 배터리 플러그인 연결 여부, 충전 상태(충전/방전), 잔량, 남은 충전 시간 등 현재 충전 상태를 조회합니다. |
| Get Powertrain Status | https://api.pleos.ai/v1/vehicles/{vin}/powertrains | 엔진, 전기 모터, 배터리 등 파워트레인의 현재 상태를 조회합니다. |
| Get Location Info | https://api.pleos.ai/v1/vehicles/{vin}/locations | 차량의 위치를 나타내는 위도 및 경도 좌표, 고도, 방향, 속도를 조회합니다. |
| Get Vehicle Operation Status | https://api.pleos.ai/v1/vehicles/{vin}/driving | 시동 상태, 누적 주행 거리, 주차 상태 등 개인의 차량 운행 상태를 조회합니다. |
| Get Vehicle Status | https://api.pleos.ai/v1/vehicles/{vin}/status | 도어 및 트렁크 열림 상태, 타이어 공기압, 경고등, 공조 시스템 등 차량 센서 기반 현재 상태를 조회합니다. |
| Get Freezer Status | https://api.pleos.ai/v1/vehicles/{vin}/freezer | 냉동고의 현재 작동 상태와 내부 온도를 조회합니다. |
| Get Powertrain Data | https://api.pleos.ai/v1/vehicles/{vin}/powertrains/data | 배터리 팩 전압과 엔진 정보(RPM, 오일 온도, 누적 운행 시간) 등 파워트레인의 기초 데이터를 조회합니다. |
| Get Speed Data | https://api.pleos.ai/v1/vehicles/{vin}/speed | 차량의 속도 관련 기초 데이터를 조회합니다. |
| Get Vehicle Operation Data | https://api.pleos.ai/v1/vehicles/{vin}/driving/data | 시동 상태, 누적 주행 거리, 주차 상태 등 개인의 차량 운행 관련 기초 데이터를 조회합니다. |
| Get Vehicle Data | https://api.pleos.ai/v1/vehicles/{vin}/status/data | 도어 열림 상태, 연료 부족 경고등, 타이어 공기압 등 차량 센서 기반 기초 데이터를 조회합니다. |
인증
Vehicle Data API는 OAuth 2.0 기반 토큰 인증을 사용합니다.
Access token을 발급받은 뒤, 이후 요청의 Authorization 헤더에 포함해야 합니다.
인증 절차와 Authentication & Authorization API는 사용자 유형에 따라 다릅니다.
| 유형 | 인증 가이드 |
|---|---|
| Private Users | For Private Users |
| Business Users | For Business Users |
사용 가능 지역
주의
Vehicle Data API는 현재(2026.8월) 유럽 지역에서만 사용 가능합니다. Private Users를 위한 내 차량 API 키 발급 기능도 유럽 지역에서만 제공됩니다. 다른 지역 서비스는 준비 중입니다.