게임플레이 파트너 가이드

테마 전환

공유 웹훅 연동 ​

이 문서는 게임플레이 파트너사의 연동에 필요한 카카오디벨로퍼스 공식 가이드 내용을 요약한 안내입니다.
실제 구현 전 반드시 카카오톡 공유 웹훅 공식 가이드에서 최신 요청·응답·인증 규격과 제약사항을 확인하세요.

카카오톡 공유 발생 후 카카오디벨로퍼스 연동을 통해 보상 가능 여부 판정 참고 데이터를 수신할 수 있습니다.
파트너사는 이 문서의 규격을 참고해 수신 API 엔드포인트를 자체 구현하고, 카카오디벨로퍼스의 [앱] > [웹훅] > [카카오톡 공유 웹훅] 에 수신 URL을 등록합니다.
웹훅 URL은 HTTPS와 443 포트만 등록할 수 있습니다.

공유 SDK 호출 시 server_callback_args에 담은 식별 값이 웹훅 본문으로 echo back되어, 카카오 서버가 공유 컨텍스트를 복원하고 보상 판정 참고 데이터를 파트너사 서버로 전달합니다.

관련 가이드: 공유 설정

파트너사 처리 요구사항 ​

  • 수신 API는 3초 이내에 HTTP 상태 코드 2XX로 응답해야 합니다. 권장이 아니라 필수 응답 규격입니다.
  • 3초 안에 처리를 끝낼 수 없다면 이벤트를 먼저 수신·저장해 응답하고 보상 판정은 비동기로 처리합니다.
  • 응답이 없거나 지연되면 재시도가 발생하므로, 같은 이벤트를 여러 번 받아도 결과가 같도록 멱등 처리합니다.

참고 문서 ​