Get Powertrain Status

Description

엔진, 전기 모터, 배터리 등 파워트레인의 현재 상태를 조회합니다.

Endpoint

GET https://api.pleos.ai/v1/vehicles/{vin}/powertrains

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/powertrains" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Brand: hyundai"

Header Params

파라미터	타입	설명	필수 여부
Authorization	string	액세스 토큰	Required
Brand	string	차량 브랜드(hyundai/kia/genesis)	Required

Path Params

파라미터	타입	설명	필수 여부
vin	string	차량 식별 번호(Vehicle Identification Number)	Required

Response

성공

200

{
  "data": {
    "engine": {
      "fuelLevel": 0
    },
    "batteries": [
      {
        "type": "main",
        "remainRatio": 30.5
      }
    ],
    "distanceToEmpties": [
      {
        "type": "EV",
        "value": "106",
        "unit": "km"
      }
    ],
    "timestamp": "2025-09-01T00:10:00Z"
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

data 필드	타입	설명
engine	object	엔진 정보
└─ fuelLevel	number	내연기관 차량의 연료량 (단위: %, 범위: 0~100) - null: EV 또는 FCEV 차량
batteries	array	배터리 정보
└─ type	string	배터리 종류 - main: EV 배터리
└─ remainRatio	integer	고전압 배터리의 잔량 (단위: %, 범위: 0~100)
distanceToEmpties	array	기관별 주행 가능 거리
└─ type	string	연료 유형 - ICE: 내연기관 - EV: 전기차 - HEV: 하이브리드 - PHEV: 플러그인 하이브리드 - FCEV: 수소전기차 - invalid: 수집 에러
└─ value	string	주행 가능 거리 (범위: 1~4095, invalid: 수집 에러)
└─ unit	string	주행 가능 거리 단위 (feet, km, meter, miles, invalid)
timestamp	string	차량 데이터 발생 시각 (UTC+0 기준) yyyy-MM-dd'T'HH:mm:ss'Z'

실패

4002

{
  "error": {
    "code": "4002",
    "message": "Invalid request parameters",
    "details": [],
    "timestamp": "2025-09-01T12:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

[에러 코드]

실패 시 에러 코드에 대한 상세한 설명은 에러 코드를 참조합니다.