失敗したWebhookイベントを再配信する

保存されたWebhookイベント1件の新しい配信を待機中にし、保持されたイベントIDと新しい配信IDを区別して受信側の結果を確認します。

最終確認日

スクリーンショットは英語版の画面です。

手動再配信では、保存済みイベントの新しい試行レコードが作成されます。完全に同じペイロードとイベントIDをコピーし、新しい配信IDを割り当てて、通常の再試行サイクルをもう一度開始します。

失敗した配信を1件選び、Redeliverを待機中にし、保持されたイベントIDと新しい配信IDを区別して、新しい行を確認する4つのパネル。
失敗した配信を1件選び、Redeliverを待機中にし、保持されたイベントIDと新しい配信IDを区別して、新しい行を確認する4つのパネル。スクリーンショットを原寸大で開く。

手順

  1. 再配信する前に受信側を修復し、イベントIDによる冪等性を確認してください。受信側が配信IDだけで重複を排除している場合、手動再配信で後続の処理が重複する可能性があります。
  2. 連携 → Webhookを開き、エンドポイントを選んで配信を展開します。イベントの種類、作成時刻、レスポンスまたはエラー、試行回数から必要な失敗行を特定してください。
  3. 応答が失敗していてもイベントがすでに後続の状態を変更したか確認します。変更済みの場合はその状態を保持し、再配信を冪等性レコードで処理してください。
  4. 選択した行の再配信を選びます。UIではどのステータスにもこの操作がありますが、意図的な2回目の配信が安全な場合を除き成功行を再配信しないでください。
  5. **再配信を待機中にしました。 — 新たな配信の試行を予約しました。**は予定されたことの確認として扱ってください。このルートは元のevt_… IDと本文を保持し、試行回数0の新しいwhd_…配信を作成します。
  6. 最近の配信の1ページ目を更新し、新しい行が成功または予定された再試行を示すまで確認します。受信側で新しい配信IDを照合し、イベントIDによって処理が重複していないことを確認してください。

手動再配信はそれぞれ標準のバックオフで最大6回試行できます。dosyaはエンドポイントが大量の送信元になるのを防ぐため、この操作をユーザーごとに5分間で20リクエストに制限します。

失敗したWebhookイベントの再配信に関する参考画面。Get API KeyとView SDKsのリンクを示すdosya REST API概要。
失敗したWebhookイベントの再配信に関する参考画面。Get API KeyとView SDKsのリンクを示すdosya REST API概要。スクリーンショットを原寸大で開く。

期待される結果

新しい配信レコードが元のイベントを運び、修復された受信側に届きます。追跡用の配信IDは変わり、冪等性に使うイベントIDは変わらず、後続の結果は1回だけ存在します。

**再配信できませんでした。**は信頼できる再配信の受領確認が返されなかったことを意味します。応答の遅れによって不要な重複が待機中にならないよう、再度クリックする前に配信一覧を再読み込みしてください。

新しい行が保留中のままです。 次の再試行を確認してください。2xx以外のレスポンスや10秒のタイムアウトは、すぐに成功するのではなく通常のスケジュールに従います。

関連ガイド

この記事は役に立ちましたか?

評価の結果を読み込んでいます…

投票すると、回答を変更できるように、必要な投票用Cookieが最長180日間保存されます。

質問と回答

このガイドの手順について質問できます。質問は確認後に公開されます。

公開の質問には、アカウントの詳細、認証情報、非公開ファイルを含めないでください。これらについては 非公開サポート をご利用ください。

質問を読み込んでいます…

    dosyaアカウントにサインインすると、質問を投稿できます。

    やり直す前に結果を確認

    操作をもう一度確認する必要があるときは、次の共通の確認事項をご利用ください。