이 문서는 카카오 로그인 관련 콜백 정보를 안내합니다.
이용 정책에서 콜백 사용 시 주의사항을 확인해야 합니다.
메서드 | URL | 인증 방식 |
---|---|---|
GET/POST |
[내 애플리케이션] > [카카오 로그인] > [연결 끊기]에서 콜백 URL 등록 (예: https://example.com/unlink/callback ) |
서비스 앱 어드민 키 |
권한 | 사전 설정 | 카카오 로그인 | 동의항목 |
---|---|---|---|
- | 카카오 로그인 활성화 연결 끊기 |
- | - |
연결 끊기 알림은 사용자가 서비스 외부에서 각 서비스 애플리케이션(이하 앱)과의 연결을 해제할 경우, 카카오 서버가 사용자의 연결 끊기 요청을 서비스 서버로 전달하는 기능입니다. 다음과 같은 경우에 연결 끊기 알림이 전달됩니다.
연결 끊기 API를 호출해 서비스가 사용자와의 연결을 끊은 경우에는 연결 끊기 알림이 발송되지 않습니다.
사용자가 연결 끊기를 요청하면 카카오에서는 더 이상 해당 서비스를 사용할 수 없다는 점을 안내합니다. 해당 서비스에서도 서비스 데이터베이스(DB)에서 연결을 끊은 사용자 정보를 처리해야 합니다. 연결 끊기 알림을 설정하면 서비스에게도 특정 사용자가 앱 연결을 끊은 사실을 알리므로, 서비스 자체 정책에 따라 탈퇴 처리할 수 있습니다.
이 기능을 사용하려면 먼저 연결 끊기에서 콜백 URL 및 요청 방법(Method)을 지정해야 합니다. 콜백은 리다이렉트를 지원하지 않습니다.
요청 헤더는 앱 어드민 키를, 본문은 앱 ID(app_id
)와 회원번호(user_id
), 연결 끊기 요청 경로(referrer_type
)를 각각 포함합니다. 앱 어드민 키와 앱 ID로 요청의 유효성을 검증해야 합니다. 아래의 요청 전문 예제를 참고합니다.
연결 끊기 알림은 카카오 서버가 사용자에 대한 연결 끊기 처리를 완료한 후 발송됩니다. 연결 끊기 알림을 받았다면 사용자가 앱과의 연결을 이미 끊은 것이므로, 서비스 서버에서도 해당 사용자 정보를 삭제하는 등 개인정보 처리방침에 따른 조치를 취한 뒤 카카오 서버에 응답해야 합니다. 일반적으로 다음과 같이 처리합니다.
200 OK
로 응답해야 합니다.200 OK
로 응답해야 합니다. 이후 서비스 내부적으로 사용자 정보 삭제 및 관련 작업을 다시 처리합니다.이름 | 설명 | 필수 |
---|---|---|
Authorization | Authorization: KakaoAK ${APP_ADMIN_KEY} 인증 방식, 서비스 앱 어드민 키로 인증 요청 |
O |
이름 | 타입 | 설명 | 필수 |
---|---|---|---|
app_id | String |
사용자가 연결 끊기를 요청한 앱 ID | O |
user_id | String |
연결 끊기를 요청한 사용자의 회원번호 | O |
referrer_type | String |
연결 끊기 요청 경로ACCOUNT_DELETE : 카카오계정 탈퇴FORCED_ACCOUNT_DELETE : 장기 휴면 또는 고객센터를 통한 카카오계정 강제 탈퇴UNLINK_FROM_ADMIN : 카카오 관리자로 인한 탈퇴 처리UNLINK_FROM_APPS : 카카오계정 페이지를 통한 서비스 연결 끊기INCOMPLETE_SIGN_UP : 가입 미완료 사용자 연결 끊기 처리(공지사항 참고) |
O |
curl -v -G GET "${YOUR_UNLINK_CALLBACK_URL}?app_id=123456&user_id=1234567890&referrer_type=UNLINK_FROM_APPS" \
-H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}"
curl -v -X POST "${YOUR_UNLINK_CALLBACK_URL}" \
-H "Authorization: KakaoAK ${SERVICE_APP_ADMIN_KEY}" \
--data-urlencode "app_id=123456" \
--data-urlencode "user_id=1234567890" \
--data-urlencode "referrer_type=UNLINK_FROM_APPS"
연결 끊기 알림을 받으려면 사용자가 연결을 끊는 상황을 만들어야 합니다. 카카오계정 페이지 또는 카카오톡의 더보기 탭에 있는 카카오계정 관리 메뉴에서 연결 끊기 기능을 제공합니다. 이 기능을 사용해 연결 끊기 알림 및 서비스 서버의 처리가 정상적으로 이뤄지는지 확인할 수 있습니다.