テスト用Webhookを送信する

署名付きのdosyaのfile.uploadedサンプルを送信し、受信側と最近の配信を確認して、待機中のテストと成功したレスポンスを区別します。

最終確認日

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

テストは実際の署名付きWebhook配信ですが、直後のトーストは作成を示すもので、受信側の成功を示すものではありません。配信の確認には作成された行と受信側のログを使用してください。

Send test eventを選択して固定の署名付きサンプルを作成し、予定されたことを示す確認を読み、Recent deliveriesを開いて受信側の結果を確認する4つのパネル。
Send test eventを選択して固定の署名付きサンプルを作成し、予定されたことを示す確認を読み、Recent deliveriesを開いて受信側の結果を確認する4つのパネル。スクリーンショットを原寸大で開く。

手順

  1. 連携 → Webhookを開き、ワークスペースを選んで完全なURLから対象のエンドポイントを探します。この操作にはmanage_settingsを持つロールが必要です。エンドポイントが無効でもテストルートを使用できます。
  2. 安全な識別子を記録し、現在の署名シークレットを検証するよう受信側を準備してください。テスト中はリクエスト本文全体や署名をログに記録しないでください。
  3. テストイベントを送信を選択します。dosyaはfile_id: "test_file"、name: "test.txt"、size: 12、folder_id: null、version: 1、is_new_version: false、test: trueを含むfile.uploadedイベントを作成します。
  4. **テストイベントを送信しました。 — 結果は下の配信ログで確認してください。**を確認します。これはwhd_…行が作成され、初回試行が予定されたことを意味します。エンドポイントが2xxを返したとは示していません。
  5. 最近の配信を開いて新しいfile.uploaded行を確認します。受信側でX-Dosya-Event-IdとX-Dosya-Delivery-Idを照合し、成功、2xxレスポンス、期待する試行回数を確認してください。
  6. 行が保留中の場合はテストを繰り返し送信せず次の再試行を使用してください。失敗の場合は保存されたレスポンスまたは通信エラーを修正し、新しい制御されたテストを1件作成して一連の動作を確認します。

各テストは通常の合計6回の再試行スケジュールに従う場合があり、エンドポイントの健全性に関する失敗にも加算されます。dosyaはテストの作成をユーザーごとに5分間で20リクエストに制限します。

テスト用Webhookの送信に関する参考画面。Get API KeyとView SDKsのリンクを示すdosya REST API概要。
テスト用Webhookの送信に関する参考画面。Get API KeyとView SDKsのリンクを示すdosya REST API概要。スクリーンショットを原寸大で開く。

期待される結果

署名付きサンプルが1件受信側に表示され、最近の配信で成功に達します。固定のtest_fileペイロードは実際のアップロードと明確に区別でき、シークレットはログに入りません。

**テストできませんでした。**はdosyaがテストリクエストを作成できなかったことを意味します。返されたエラーを読み、権限と回数制限の状態を確認し、行がないことを受信側の問題とみなさないでください。

行にErrorと表示されます。 DNS、TLS、公開HTTPSの検証、リダイレクトの動作、受信側のタイムアウトを確認してください。通信エラーにはHTTPステータスがありません。

関連ガイド

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

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

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

質問と回答

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

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

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

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

    やり直す前に結果を確認

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