이 문서는 카카오 API 플랫폼에서 제공하는 콜백(Callback) 기능을 안내합니다.
서비스 외부에서 발생하는 사용자의 상태 변화나 이벤트에 대처할 수 있도록 콜백 기능을 제공합니다. 현재 제공 중인 콜백의 목록은 다음과 같습니다.
콜백 | 설명 | 제공 대상 |
---|---|---|
연결 끊기 알림 | 사용자 카카오계정과 서비스 앱의 연결이 끊어졌을 때 콜백을 받아 서비스에서도 해당 사용자를 탈퇴 처리할 수 있도록 지원하는 기능 | 카카오 로그인을 사용하는 서비스 |
보안 이벤트 구독 | 서비스에 사용자의 보안 이벤트 정보를 전달하는 기능 | 카카오 로그인을 사용하는 서비스 |
카카오톡 공유 전송 성공 알림 | 카카오톡 공유 메시지가 성공적으로 전송됐을 때, 전송된 메시지의 정보를 서비스에 전달하는 기능 | 카카오톡 공유를 사용하는 서비스 |
카카오톡 채널 관계 알림 | 서비스의 카카오톡 채널을 사용자가 친구로 추가했거나 차단했을 때 알림을 받는 기능 | 카카오톡 채널을 사용하는 서비스 |
콜백 기능 사용 시, 서비스 서버 ACL(Access Control List)에 카카오 API 플랫폼의 IP를 허용하도록 등록해야 합니다. 허용해야 할 IP 목록을 확인하려면 카카오 IP 목록 가져오기를 호출합니다.
* 2023년 6월 1일 변경됨, 공지사항 참고
서비스 서버는 각 콜백 요청에 대해 HTTP 상태 코드 200 OK
로 응답해야 합니다. 요청에 대한 타임아웃(3초)이 있습니다. 카카오는 응답 본문과 관계없이 HTTP 상태 코드만으로 요청 성공 여부를 확인합니다.
1개월 이상 콜백 수신 응답이 없거나 오류 발생 빈도가 높은 경우, 각 콜백 기능을 [일시중지] 상태로 변경합니다. 이 경우, 다시 사용 설정하기 전까지 해당 콜백이 발송이 중단됩니다.