본문으로 건너뛰기

차량 선택 및 차량 데이터 공유 동의

[사전 절차]

이 토픽의 절차를 수행하기 위해서는 인증을 통해 필요한 파라미터를 획득해야 합니다.

STEP 1. 차량 데이터 공유 동의 웹뷰 URL 조회​

차량 소유자로부터 차량 데이터 공유 동의를 획득하기 위해서 차량 선택 및 차량 데이터 공유 동의 창을 제공해야 합니다.
Select Vehicles를 호출하여 차량 선택 창의 웹뷰 URL을 조회합니다.

curl
curl -X GET "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"
  }
  • 정상적인 호출 시 웹뷰 URL이 반환됩니다.
  • 반환받은 URL을 호출하면 차량 소유자에게 차량 선택 및 차량 데이터 공유 동의 창이 출력됩니다.

STEP 2. 차량 선택 및 데이터 공유 동의​

STEP 1에서 출력한 화면에서 차량 소유자가 데이터를 공유할 차량을 선택한 후 데이터 공유에 동의하거나 거절합니다.
동의 여부에 관련 없이 동의완료 리다이렉트 URL로 STEP 1의 완료를 알려줍니다.
차량 소유자가 차량 데이터 공유에 동의한 경우 동의완료 리다이렉트 URL에 데이터 공유에 동의한 차량 식별번호가 vehicles 파라미터로 전달됩니다.

  • Vehicle Data API 신청 시 입력했던 동의완료 리다이렉트 URL이 호출됩니다.
  • 반환되는 vehicles 파라미터는 vin 값으로 구성된 배열이며, Base64로 인코딩되어 있습니다.
  • vehicles를 Base64로 디코딩하여 얻은 차량 식별 번호를 Vehicle Data API 호출 시 경로 파라미터로 사용합니다.
정보
  • 동의완료 리다이렉트 URL은 Pleos Playground 프로젝트의 API 신청 시 입력한 정보입니다.
  • API 신청 내역페이지에서 해당 URL 정보를 확인하거나 수정할 수 있습니다.
주의

개발사는 차량 소유자가 동의했던 데이터 공유를 철회할 수 있도록 기능을 구현해야 합니다. Stop Data Sharing를 사용하여 이 기능을 구현할 수 있습니다.

STEP 3. 차량 목록 조회하기​

차량 소유자가 데이터 공유 동의한 차량의 목록을 조회합니다.
Get Vehicles를 호출하여 차량 목록을 조회합니다.

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" \
  • 반환되는 차량이 없는 경우 STEP 1을 진행합니다.
  • 반환되는 차량이 있는 경우 차량 식별 번호를 확인하여 Vehicle Data API 호출 시 경로 파라미터로 사용합니다.