Select Vehicles

Description

Vehicle Data를 조회하기 위하여 연결할 차량을 선택합니다.

• 이 API를 사용하려면 액세스 토큰 발급이 선행되어야 합니다.
• 정상적인 호출 시 웹뷰 URL이 반환됩니다.
• 반환받은 URL을 호출하면 차량 소유자에게 차량 선택 및 차량 데이터 공유 동의 창이 출력됩니다.

Endpoint

POST https://api.pleos.ai/v1/vehicles/selections

Request

curl

curl -X POST "https://api.pleos.ai/v1/vehicles/selections" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json" \
  -H "Brand: hyundai" \
  -d '{
    "state": "state",
    "lang": "en"
  }'

Header Params

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

Body Params

파라미터	타입	설명	필수 여부
state	string	애플리케이션에서 요청한 상태 토큰 값	Required
lang	string	웹뷰로 사용자에게 보여줄 차량 선택 화면의 언어	Required

Response

성공

200

{
  "data": {
    "redirectUrl": "https://api.pleos.ai/v1/vehicles/select-vehicle?lang=en&sessionId=abcdefgh-4098-488f-a20b-77072257c1234&gwToken=Bearer%20gBearer%20gMhJJYUepuP93SHsHwEILHzHiuXQ5X7kfBIe6L3I1ic1Sble4OHX7"
  },
  "meta": {
    "code": 200,
    "message": "Success",
    "success": "true",
    "timestamp": "2025-09-01T11:00:00Z",
    "requestId": "835bdbd4-1105-4a8c-b438-a1b2c3d4f5g6"
  }
}

data 필드	타입	설명
redirectUrl	string	차량 선택 창을 호출할 수 있는 URL이 반환됩니다.

실패

4002

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

[에러 코드]

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