사용자에 의한 데이터 공유 동의 철회 알림
사용자가 차량 계약을 해지하거나, 차량 개통한 계정을 탈퇴하거나, 커넥티드 서비스(블루링크 커넥트 서비스, 기아 커넥트 서비스, 제네시스 커넥트 서비스)를 해지하거나, 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
Request Body
등록된 콜백 URL로 전달되는 요청 본문입니다.
{
"userIds": ["UUID"],
"vins": ["vin1", "vin2"]
}
| Body Parameter | Type | Description |
|---|---|---|
| userIds | array<string> | 차량 소유자의 현대/기아/제네시스 계정의 UUID |
| vins | array<string> | Vehicle Identification Number |