차량 소유자에 의한 데이터 공유 동의 철회 알림

차량 소유자가 차량 계약을 해지하거나, 차량 개통한 계정을 탈퇴하거나, 커넥티드 서비스(블루링크 커넥트 서비스, 기아 커넥트 서비스, 제네시스 커넥트 서비스)를 해지하거나, My Hyundai/Kia App/MY GENESIS 앱에서 데이터 공유 동의를 철회하는 등 고객 요청에 의해 데이터 공유가 중단된 경우, 시스템은 등록된 동의철회 콜백 URL로 POST 요청을 보냅니다.

이 알림을 수신하는 클라이언트 시스템은 해당 차량에 대하여 Vehicle Data API를 통해 제공받은 데이터를 즉시 일괄 삭제하고 서비스에 더 이상 표출되지 않도록 조치해야 합니다.

정보

• 동의철회 콜백 URL은 Vehicle Data API 신청 시 사용자 인증 정보 > 개인정보 제3자동의 > 동의철회 콜백 URL 항목에 입력된 URL입니다.
• API 신청 내역 페이지에서 해당 URL 정보를 확인하거나 수정할 수 있습니다.

Callback Request

Endpoint

시스템은 POST 메소드를 사용하여 콜백 URL로 요청을 보냅니다.

POST https://www.example.com/datasharing-end-callback

Body Parameters

등록된 콜백 URL로 전달되는 요청 본문입니다.

{
  "userIds": ["UUID"],
  "vins": ["vin1", "vin2"]
}

Body Parameter	Type	Description
userIds	array<string>	차량 소유자의 현대/기아/제네시스 계정의 UUID
vins	array<string>	Vehicle Identification Number