웹훅
웹훅을 사용하면 데이터가 사용 가능한지 확인하기 위해 API를 폴링하는 대신 k-ID 엔진에서 발생하는 이벤트에 실시간으로 구독할 수 있습니다.
웹훅은 다음과 같은 다양한 목적으로 사용할 수 있습니다:
- 도전 완료 결과 처리
- 나이 확인 결과 처리
- k-ID 세션의 변경사항 처리
웹훅 설정
웹훅은 개발자 포털에서 이벤트가 발생할 때 k-ID 엔진이 호출할 URL을 지정하여 구성됩니다. URL은 보안 HTTPS URL이어야 합니다. k-ID 엔진은 이벤트 데이터를 포함하는 JSON 페이로드와 함께 URL에 POST 요청을 전송합니다.
웹훅은 개별 제품과 연결됩니다. 둘 이상의 k-ID 제품이 있는 경우 모 든 제품에 대해 동일한 엔드포인트를 사용할 수 있지만, API 호출(예: /session/get
)을 위해 올바른 제품별 k-ID API 키를 검색해야 한다는 점을 주의해야 합니다.
웹훅은 선택된 제품의 개발자 설정에서 구성할 수 있습니다. /products/[productId]/developer
에서 이 페이지에 액세스할 수 있습니다.
웹훅 구성 페이지
개발자 설정의 웹훅 섹션을 통해 특정 이벤트가 발생할 때 k-ID가 호출할 HTTPS URL을 구성할 수 있습니다. 애플리케이션에 대한 원하는 웹훅 URL을 입력하고 저장을 클릭하면 시스템에서 구성이 업데이트됩니다. 변경사항은 현재 설정에 따라 테스트 모드 또는 라이브 모드의 적절한 환경에 자동으로 적용됩니다.
이를 통해 테스트 중이든 프로덕션에서 운영 중이든 이벤트 알림이 애플리케이션으로 올바르고 안전하게 라우팅됩니다.
참고: 저장 버튼은 테스트로 푸시 및 라이브 게시 버튼과 다릅니다. 웹훅을 저장하고 업데이트하는 것은 사용자에게 직접적인 영향을 주지 않지만, 테스트로 푸시 또는 라이브 게시