メインコンテンツへスキップ

フォールバック戦略

Webhookサービスが利用できない場合に備えて、アプリケーションが期待する応答時間内にプロセス結果を取得できるよう、フォールバックメカニズムを実装することを推奨します。

仕組み

Webhookはプライマリの結果配信メカニズムです。ただし、以下のシグナルを GET /client/v1/process/{processId} 経由で結果を能動的に取得する追加トリガーとして扱う必要があります:

シグナルチャネル提供されるもの
onFinish コールバックSDK Web / WebMobileジャーニー終了シグナル — 結果なし
callbackUri リダイレクトその他すべてのチャネルURL リダイレクトのみ — 結果なし
警告

onFinishcallbackUri もプロセス結果を直接配信しません。これらはジャーニー終了シグナルに過ぎません。バックエンドは受信した id(またはリダイレクト)を以前に保存した processId と紐付け、GetProcess を呼び出して実際の結果を取得する責任があります。

推奨フロー

ジャーニー終了シグナルを受信したら、バックエンドは GET /client/v1/process/{processId} を呼び出し、以下の順序で結果を検証します:

  1. state = PROCESS_STATE_FINISHED を確認する
  2. result フィールドを評価し、ビジネスルールを適用する

これにより、Webhookが一時的に利用できない場合でもプロセス結果が失われないようになります。