Get Vehicle Data

Description

도어 열림 상태, 타이어 공기압, 연료 부족 경고등 등 차량 센서 기반 기초 데이터를 조회합니다.

Endpoint

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

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/status/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,
        "doors": {
          "openAssistance": [
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close"
          ],
          "openDriver": [
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close"
          ],
          "openRearLeft": [
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close"
          ],
          "openRearRight": [
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close",
            "close"
          ]
        },
        "lamp": {
          "setting": [
            "lightSwOff",
            "lightSwOff",
            "lightSwOff",
            "lightSwOff",
            "lightSwOff",
            "lightSwOff",
            "lightSwOff",
            "lightSwOff",
            "lightSwOff",
            "lightSwOff"
          ]
        },
        "tire": {
          "pressureFrontLeft": [
            255, 255, 255, 255, 255, 255, 255, 255, 255, 255
          ],
          "pressureFrontRight": [
            255, 255, 255, 255, 255, 255, 255, 255, 255, 255
          ],
          "pressureRearLeft": [
            255, 255, 255, 255, 255, 255, 255, 255, 255, 255
          ],
          "pressureRearRight": [
            255, 255, 255, 255, 255, 255, 255, 255, 255, 255
          ],
          "pressureUnit": [
            "psi",
            "psi",
            "psi",
            "psi",
            "psi",
            "psi",
            "psi",
            "psi",
            "psi",
            "psi"
          ]
        },
        "warnings": {
          "lowFuelLevel": [
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off",
            "off"
          ]
        },
        "outsideTemperature": {
          "value": [27.5, 27.5, 27.5, 27.5, 27.5, 27.5, 27.5, 27.5, 27.5, 27.5]
        }
      }
    ]
  },
  "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)
└── doors	object	문 상태 정보
└────── openAssistance	array of string	조수석 문 상태 (open, close)
└────── openDriver	array of string	운전석 문 상태 (open, close)
└────── openRearLeft	array of string	왼쪽 뒷문 상태 (open, close)
└────── openRearRight	array of string	오른쪽 뒷문 상태 (open, close)
└── lamp	object	램프 상태 정보
└────── setting	array of string	사용자가 설정한 외부 램프의 상태 - lightSwOff: 라이트 꺼짐 - tailSwOn: 후면등 켜짐 - headLampLowSwOn: 전조등 켜짐 - autoLightSwOn: 오토 라이트 기능 켜짐
└── tire	object	타이어 공기압 정보
└────── pressureFrontLeft	array of number	왼쪽 앞 타이어 공기압 (0~254: valid, 255: invalid)
└────── pressureFrontRight	array of number	오른쪽 앞 타이어 공기압 (0~254: valid, 255: invalid)
└────── pressureRearLeft	array of number	왼쪽 뒤 타이어 공기압 (0~254: valid, 255: invalid)
└────── pressureRearRight	array of number	오른쪽 뒤 타이어 공기압 (0~254: valid, 255: invalid)
└────── pressureUnit	array of string	타이어 공기압 단위 (psi, kpa, bar)
└── warnings	object	경고등 정보
└────── lowFuelLevel	array of string	연료량이 부족할 때의 경고 상태 (on, off)
└── outsideTemperature	object	차량의 외기 온도 정보
└────── value	array of number	차량의 외기 온도 (단위:°C, 범위: -40~60)

타이어 압력 단위에 따른 값의 계산

'tire.pressureUnit' 설정에 따라 'tire.pressureFrontLeft' 등 압력 값을 변환하여 사용해야 합니다.

타이어 압력 단위	타이어 압력 값	물리값 변환 로직	실제 물리값
psi	52	가공 불필요	52 psi
kpa	72	value * 5	360 kpa
bar	36	value / 10	3.6 bar

실패

4002

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

[에러 코드]

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