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