Get Powertrain Data

Description

배터리 팩 전압과 엔진 정보(RPM, 오일 온도, 누적 운행 시간) 등 파워트레인의 기초 데이터를 조회합니다.

Endpoint

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

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/powertrains/data?startDate=20250825&endDate=20250901&zoneId=UTC" \
  -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

Query Params

파라미터	타입	설명	필수 여부	기본값
startDate	string	yyyyMMdd	Required	없음
endDate	string	yyyyMMdd (시작일로부터 최대 7일간 조회 가능)	Required	없음
zoneId	string	Timezone Id	Optional	UTC

Response

성공

200

{
  "data": {
    "trips": [
    {
      "triggerStartTime": "2025-09-01T10:00:00.000Z",
      "tripLength": 10000,
      "batteries": {
        "hv": {
          "voltage": [
            263.1,
            262.7,
            262.5,
            262.6,
            262.5,
            262.4,
            262.4,
            262.3,
            262.1,
            262.1
          ]
        }
      },
      "engine": {
        "oilTemperature": [
          29,
          29,
          29,
          29,
          29,
          29,
          28.25,
          28.25,
          28.25,
          28.25
        ],
        "rpm": [
          0,
          122,
          1153,
          1279,
          1320,
          1250,
          1172,
          1173,
          520,
          0
        ]
      }
    }
  ]
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }  
}

data 필드	타입	설명
trips	array of object	트립 데이터
└──── triggerStartTime	string	엔진 시동 시작 시간 yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
└──── tripLength	long	차량 주행 시간 (단위: ms)
└──── batteries	object	배터리 정보
└─────── hv	object	고전압 배터리 정보
└────────── voltage	array of number	배터리 팩의 최대 전압 (단위: V, 범위: 0~6553)
└──── engine	object	엔진 정보
└─────── oilTemperature	array of number	엔진 오일 온도 (단위: °C, 범위: 0~150.5)
└─────── rpm	array of number	엔진의 회전 속도 (단위: rpm, 범위: 0~16383.5)

실패

4002

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

[에러 코드]

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