폴백 전략
webhook 서비스가 사용 불가능한 경우, 애플리케이션이 예상 응답 시간 내에 프로세스 결과를 계속 조회할 수 있도록 폴백 메커니즘을 구현하는 것을 권장합니다.
작동 방식
webhook은 기본 결과 전달 메커니즘입니다. 그러나 다음 신호들을 GET /client/v1/process/{processId}를 통해 결과를 능동적으로 가져오는 추가 트리거로 처리해야 합니다:
| 신호 | 채널 | 제공 내용 |
|---|---|---|
callbackUri 리디렉션 | Human Token Journey (humantoken) | URL 리디렉션만 — 결과 없음 |
경고
callbackUri는 프로세스 결과를 직접 전달하지 않습니다. 이것은 여정 종료 신호일 뿐입니다. 백엔드는 리디렉션을 이전에 저장한 processId와 연결하고, GetProcess를 호출하여 실제 결과를 조회할 책임이 있습니다.
권장 흐름
여정 종료 신호를 받으면 백엔드는 GET /client/v1/process/{processId}를 호출하고 다음 순서로 결과를 검증해야 합니다:
state = PROCESS_STATE_FINISHED확인result필드를 평가하고 비즈니스 규칙 적용
이를 통해 webhook이 일시적으로 사용 불가능하더라도 프로세스 결과가 손실되지 않습니다.