APIキーと連携

ツールに必要なアクセス権を持つ認証情報を作成します。

• Webhookで購読するイベントを選ぶ ファイルのアップロード、削除、共有アクセスのイベントを選び、それぞれのペイロードを理解して、受信側が処理する変更をテストします。
• 順序どおりに届かないWebhookイベントを処理する イベントの発生情報とファイルのバージョン番号を使って古いWebhook処理を拒否し、順序を示す項目がない場合は現在の状態を照合します。
• シークレットを含めずにWebhookの診断情報を記録する 署名情報、非公開のペイロードデータ、受信側のシークレットを除き、Webhookのイベント、配信、種類、時刻、ステータスを記録します。
• Webhookペイロードのバージョンを扱う 現在のバージョン番号のないWebhookエンベロープをイベントの種類ごとに検証し、ファイルのバージョンとスキーマのバージョンを区別して、追加項目を安全に受け入れます。
• 受信側の停止後にWebhook配信を復旧する Webhook受信側を復旧して制御されたテストで確認し、エンドポイントを再度有効にして、必要な失敗イベントを重複させずに手動で再配信します。
• 失敗したWebhookイベントを再配信する 保存されたWebhookイベント1件の新しい配信を待機中にし、保持されたイベントIDと新しい配信IDを区別して受信側の結果を確認します。
• 繰り返し失敗したWebhookを再度有効にする 自動で無効になったWebhook受信側を修復してテストしてから再度有効にし、後続システムにまだ必要な失敗イベントだけを再配信します。
• Webhookの配信を安全に再試行する dosyaの合計6回の配信試行スケジュールに対応し、イベントIDによるトランザクションの冪等性を実装して、繰り返されたリクエストが後続の状態を1回だけ変更するようにします。
• Webhook署名シークレットをローテーションする Webhook署名シークレットを更新し、1回だけ表示される代替値をすぐにコピーして受信側を更新し、古いキーが使えなくなった後に新しい署名を検証します。
• テスト用Webhookを送信する 署名付きのdosyaのfile.uploadedサンプルを送信し、受信側と最近の配信を確認して、待機中のテストと成功したレスポンスを区別します。