Get Vehicle Operation Status

Description

시동 상태, 누적 주행 거리, 주차 상태 등 개인의 차량 운행 상태를 조회합니다.

Endpoint

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

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/{vin}/driving" \
  -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": {
    "ignition": {
        "status": "on",
        "ignitionDetails": [
        {
          "type": "ign1",
          "status": "on"
        },
        {
          "type": "ign3",
          "status": "on"
        },
        {
          "type": "acc",
          "status": "on"
        }
      ]
    },
    "sleepMode": "off",
    "odometer": {
      "value": 6549.2,
      "unit": "km"
    },
    "transmission": {
      "parkingPosition": false
    },
    "timestamp": "2025-09-01T09:10:00Z"
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }  
}

data 필드	타입	설명
ignition	object	엔진 시동 상태 정보
└─ status	string	엔진 시동 상태 (on, off, invalid)
└─ ignitionDetails	array	엔진 시동 상태 상세 정보
└────── type	string	차량의 전력 종류 - ign1: 시동 - ign3: 충전 중 시동 - acc: 액세서리 모드
└────── status	string	차량의 전력 상태 (on, off, invalid)
sleepMode	string	차량의 슬립 모드 상태 (on, off, invalid)
odometer	object	차량의 누적 주행 거리 정보
└─ value	number	차량의 누적 주행 거리 (범위: 0~16777214)
└─ unit	string	차량의 누적 주행 거리 단위 (km, mile, meter, feet, invalid)
transmission	object	변속기 정보
└─ parkingPosition	boolean	변속기의 주차 위치 여부
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"
  }
}

[에러 코드]

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