이벤트 개요
k-ID는 사용자 작업 및 시스템 변경에 실시간으로 대응하는 데 도움이 되는 두 가지 유형의 이벤트를 제공합니다 - DOM 이벤트 및 웹훅. 두 이벤트 유형 모두 k-ID 시스템의 중요한 변경 사항에 반응하는 반응형 통합을 구축할 수 있도록 합니다.
이벤트란 무엇인가요?
이벤트는 애플리케이션에서 특정 작업이 발생할 때 k-ID에서 보내는 알림입니다. 이를 통해 다음을 수행할 수 있습니다:
- 사용자 작업에 반응: 사용자가 확인을 완료하거나 동의를 부여하거나 위젯과 상호 작용할 때 즉시 응답
- 애플리케이션 상태 업데이트: k-ID의 상태 변경과 동기화된 애플리케이션 유지
- 비동기 작업 처리: 장기 실행 프로세스가 완료될 때 알림 받기
- 실시간 경험 구축: 자동으로 업데이트되는 반응형 사용자 인터페이스 만들기
DOM 이벤트
DOM 이벤트는 웹사이트의 iframe에서 실행되는 k-ID 위젯에서 발생하는 JavaScript 이벤트입니다. 이러한 이벤트는 브라우저의 postMessage API를 통해 전송되며 표준 JavaScript 이벤트 리스너를 사용하여 수신할 수 있습니다.
DOM 이벤트를 사용해야 하는 경우
- 반응형 UI 업데이트: 사용자가 위젯과 상호 작용할 때 인터페이스를 즉시 업데이트
- 클라이언트 측 상호 작용: 브라우저에서 위젯 상호 작용에 반응해야 하는 경우
- 실시간 사용자 피드백: 사용자에게 즉각적인 시각적 피드백 제공
주요 기능
- iframe의 위젯에서 직접 발생
- JavaScript
message이벤트 리스너를 통해 수신 - 보안을 위해 원본 검증 필요
- 클라이언트 측 JavaScript 애플리케이션 및 반응형 UI에 적합
자세한 내용은 DOM 이벤트를 참조하세요.
웹훅
웹훅은 k-ID 서버에서 서버 엔드포인트로 전송되는 HTTP POST 요청입니다. k-ID 시스템의 중요한 이벤트에 대한 서버 간 알림을 제공합니다.
웹훅을 사용해야 하는 경우
- 데이터 무결성: 데이터베이스를 안정적으로 업데이트하고 데이터 일관성 유지
- 서버 측 처리: 서버에서 이벤트를 처리해야 하는 경우
- 안정적인 전달: 사용자가 이동하더라도 처리해야 하는 중요한 이벤트
- 백그라운드 처리: 사용자 상호 작용을 차단하지 않고 비동기적으로 이벤트 처리
- 상태 동기화: 서버 상태를 k-ID의 상태와 동기화 유지
주요 기능
- 구성된 엔드포인트로 HTTP POST 요청으로 전송
- 보안 검증을 위한 암호화 서명 포함
- Compliance Studio에서 제품별로 구성
- 서버 측 통합, 데이터 무결성 및 안정적인 상태 관리에 이상적
자세한 내용은 웹훅을 참조하세요.
DOM 이벤트와 웹훅 중 선택
두 이벤트 유형은 서로 다른 목적을 제공하며 함께 사용할 수 있습니다:
| 사용 사례 | 권장 접근 방식 |
|---|---|
| 브라우저의 실시간 UI 업데이트 | DOM 이벤트 |
| 데이터 무결성 및 상태 관리 | 웹훅 또는 서버 측 API 호출 |
| 서버 측 처리 및 데이터베이스 업데이트 | 웹훅 |
| 반응형 사용자 피드백 | DOM 이벤트 |
| 안정적인 이벤트 처리 | 웹훅 |
| 위젯 상호 작용 | DOM 이벤트 |
모범 사례
반응형 UI 업데이트에는 DOM 이벤트를 사용하고, 데이터 무결성 및 안정적인 상태 관리에는 웹훅 또는 서버 측 API 호출(예: /age-verification/get-status 또는 /challenge/get-status)을 사용하세요. 많은 애플리케이션이 둘 다 사용합니다. 즉시 UI 피드백에는 DOM 이벤트를 사용하고 안정적인 서버 측 처리 및 데이터 지속성에는 웹훅을 사용합니다.