콜백

이 문서는 카카오 API 플랫폼에서 제공하는 콜백(Callback) 기능을 안내합니다.

기능 소개

서비스 외부에서 발생하는 사용자의 상태 변화나 이벤트에 대처할 수 있도록 콜백 기능을 제공합니다. 현재 제공 중인 콜백의 목록은 다음과 같습니다.

콜백	설명	제공 대상
연결 끊기 알림	사용자 카카오계정과 서비스 앱의 연결이 끊어졌을 때 콜백을 받아 서비스에서도 해당 사용자를 탈퇴 처리할 수 있도록 지원하는 기능	카카오 로그인을 사용하는 서비스
보안 이벤트 구독	서비스에 사용자의 보안 이벤트 정보를 전달하는 기능	카카오 로그인을 사용하는 서비스
카카오톡 공유 전송 성공 알림	카카오톡 공유 메시지가 성공적으로 전송됐을 때, 전송된 메시지의 정보를 서비스에 전달하는 기능	카카오톡 공유를 사용하는 서비스
카카오톡 채널 관계 알림	서비스의 카카오톡 채널을 사용자가 친구로 추가했거나 차단했을 때 알림을 받는 기능	카카오톡 채널을 사용하는 서비스

이용 정책

카카오 IP 허용

콜백 기능 사용 시, 서비스 서버 ACL(Access Control List)에 카카오 API 플랫폼의 IP를 허용하도록 등록해야 합니다. 허용해야 할 IP 목록을 확인하려면 카카오 IP 목록 가져오기를 호출합니다.

* 2023년 6월 1일 변경됨, 공지사항 참고

콜백 요청에 대한 응답

서비스 서버는 각 콜백 요청에 대해 HTTP 상태 코드 200 OK로 응답해야 합니다. 요청에 대한 타임아웃(3초)이 있습니다. 카카오는 응답 본문과 관계없이 HTTP 상태 코드만으로 요청 성공 여부를 확인합니다.

콜백 일시중지

1개월 이상 콜백 수신 응답이 없거나 오류 발생 빈도가 높은 경우, 각 콜백 기능을 [일시중지] 상태로 변경합니다. 이 경우, 다시 사용 설정하기 전까지 해당 콜백이 발송이 중단됩니다.