이벤트 유형

Markdown

웹훅 페이로드는 프로세스 상태 전환을 설명합니다. 이 페이지에서는 페이로드 스키마와 lastEvent 값의 전체 목록을 문서화합니다.

페이로드 스키마

필드	유형	설명
processId	string (UUID)	트랜잭션의 ID.
state	string	트랜잭션의 현재 상태. 현재: PROCESS_STATE_FINISHED.
flow	string	해당 트랜잭션에 대해 실행된 플로우 (예: api+humantoken, api+liveness+humantoken, humantoken, humantoken+revalidation, api+liveness+humantoken+revalidation).
lastEvent	string	트랜잭션의 마지막 이벤트. 사용자가 플로우를 완료하기 전에 프로세스가 만료된 경우에만 반환됩니다.
lastEventDescription	string	lastEvent에 대한 사람이 읽을 수 있는 설명. 사용자가 플로우를 완료하기 전에 프로세스가 만료된 경우에만 반환됩니다.

상태 용어

웹훅 페이로드의 state 필드는 PROCESS_STATE_* 접두사를 사용합니다. 이는 GetProcess 엔드포인트가 반환하는 result 및 status 필드(이 경우 PROCESS_RESULT_* 접두사 사용)와는 구별되는 용어입니다. 이 두 가지를 혼용하지 마세요.

페이로드 예시

완료됨 — 성공

{
  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "state": "PROCESS_STATE_FINISHED",
  "flow": "humantoken"
}

완료됨 — 만료됨

{
  "processId": "8263a268-5388-492a-bca2-28e1ff4a69f0",
  "state": "PROCESS_STATE_FINISHED",
  "flow": "humantoken",
  "lastEvent": "EVENT_TYPE_SESSION_ENDED",
  "lastEventDescription": "Session ended by timeout or by new session created"
}

lastEvent 열거형

lastEvent에 나타날 수 있는 값의 전체 목록:

이벤트	설명
EVENT_TYPE_PROCESS_CREATED	프로세스 생성됨
EVENT_TYPE_PROCESS_STARTED_BY_USER	사용자가 프로세스를 시작함
EVENT_TYPE_IDENTITY_VALIDATION_STEP_FINISHED	신원 확인 단계 완료됨
EVENT_TYPE_SESSION_ENDED	세션이 타임아웃으로 종료되었거나 새 세션이 생성됨

구성 가능한 처리

이벤트 집합은 변경될 수 있습니다. 엔드포인트가 반응하는 이벤트는 하드코딩된 상수가 아닌 구성으로 처리하세요 — 그러면 새로운 이벤트를 배포 없이 활성화할 수 있습니다.

전체 프로세스 결과 읽기

웹훅 페이로드는 프로세스가 완료되었음을 알리지만, 결과 자체는 포함하지 않습니다. 결과(캡처 데이터, 생체 인식 점수, 문서 필드 등과 함께)를 가져오려면 적절한 GetProcess 엔드포인트를 호출하세요. 프로세스 조회를 참조하세요.