Get Vehicles

Description

차량 소유자가 소유하고 있는 차량 중 차량 데이터 공유 동의한 차량의 목록을 조회합니다.

Endpoint

GET https://api.pleos.ai/v1/vehicles/consent

Request

curl

curl -X GET "https://api.pleos.ai/v1/vehicles/consent" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -H "Brand: hyundai" \

Header Params

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

Responses

성공

200

{
  "data": {
    "vehicles": [
      {
        "vin": "TEST111111111TEST",
        "nickname": "My Car",
        "name": "UM(UM)",
        "type": "GN",
        "sellname": "Sorento"
      }
    ]
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

data 필드	타입	설명
vehicles	array	차량 리스트
└─ vin	string	차량 식별 번호 (17자리)
└─ type	string	차량 타입 - GN: 내연기관 - EV: 전기차 - HV: 하이브리드 - PE: 플러그인 하이브리드 - FV: 수소전기차 - UNKNOWN
└─ nickname	string	사용자가 앱에서 설정한 닉네임
└─ name	string	차종명(차종코드)
└─ sellname	string	차량 판매 모델명

실패

4002

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

[에러 코드]

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