ウェブフックを使用して自分のシステムにイベントを送信

Webhookは、何かが起こった瞬間にIDupがあなたのウェブアドレスを呼び出すことを可能にします。例えば、請求書が支払われたときです。すべての配信は署名され、あなたのシステムが応答しない場合は繰り返されます。

エンドポイントを追加

1. 開く Webhook タブを押して エンドポイントを追加.
2. 入力してください 名前 および URL。それは公に到達可能でなければなりません。セキュリティ上の理由から、プライベートネットワーク内のアドレスは拒否されます。
3. チェックする イベント お望みのもの。
4. オプション: 選択する APIキー。エンドポイントは、このキーが読み取ることができるイベントのみを受け取ります。
5. プレス 保存。IDupは表示します 署名シークレット 一度だけ。安全に保管してください。

イベント

• 請求書が作成されました, 請求書が支払われました, 支払い受領
• 新しい顧客, 新しい連絡先, 新しいリード, 新しいチケット
• オファー承認済み — 顧客が承諾した見積書

すべての配送には、イベント名、配送番号、署名の3つのヘッダーが付いています。再試行時には同じ配送番号が使用されるため、システムは重複を認識できます。

署名を確認

システムは、時間と生の本文に対してHMAC-SHA256を秘密鍵で計算し、署名と比較し、5分以上前の時間を拒否する必要があります。押してください 署名の確認と例 既製のコード用。

テスト、一時停止、更新

• テストを送信 テストイベントを送信し、HTTPコードと所要時間を表示します。
• 一時停止 配達を停止します。 有効化 再開します。
• ロールシークレット 新しいシークレットを作成します。古いものはすぐに機能しなくなります。
• 削除する エンドポイントを削除します。そのログは保持されます。

再試行とログ

あなたのアドレスは5秒以内に2xxコードで応答する必要があります。リダイレクトは追跡されません。失敗した場合、IDupは1分後、5分後、30分後、2時間後、12時間後に再試行します。6回目の試行後、配信はマークされます。 諦めました.

ログは各試行をイベント、エンドポイント、試行回数、HTTPコード、期間、回答の開始と共に表示します。ステータスは 待機中, 配信済み, 失敗 または 諦めました。使用してください 再送信 配達を再送信するために。