본문으로 건너뛰기

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

[사전 절차]

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

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

차량 소유자가 데이터 공유 동의한 차량의 목록을 조회합니다.
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 2을 진행합니다.
  • 반환되는 차량이 있는 경우 차량 식별 번호를 확인하여 Vehicle Data API 호출 시 경로 파라미터로 사용합니다.

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

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

  • 정상적인 호출 시 웹뷰 URL이 반환됩니다.
  • 반환받은 URL을 호출하면 차량 소유자에게 차량 선택 및 차량 데이터 공유 동의 창이 출력됩니다.

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

STEP 2에서 출력한 화면에서 차량 소유자가 데이터를 공유할 차량을 선택한 후 데이터 공유에 동의하거나 거절합니다. 동의 여부에 상관없이 동의완료 리다이렉트 URL로 STEP 2의 완료를 알려줍니다. 그런 다음 차량 식별 번호를 조회하기 위해 STEP 1을 다시 진행합니다.

주의

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