フォールバック戦略
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が一時的に利用できない場合でもプロセス結果が失われないようになります。