メインコンテンツへスキップ
POST
curl
呼び出すたびにWebhookが再度配信されます。一括で再送する前に、エンドポイントがevent_idに基づいて冪等に動作するようにしてください。また、再送するのはresponse_statusがnull、または400以上の配信のみにしてください。
再送は、元の配信で使用されたURLに送られます。送信先を新しいURLに変更した場合でも、過去の配信は引き続き古いURLを指しています。再送する配信はWebhookの送信先の配信一覧を取得で確認してください。署名検証についてはWebhookガイドを参照してください。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

パスパラメータ

destination_uuid
string<uuid>
必須

配信が送られた送信先のUUIDです。

delivery_uuid
string<uuid>
必須

再送する配信のUUIDで、GET /v3/webhook/destinations/{destination_uuid}/deliveries/が返すエントリーのuuidです。

レスポンス

すでに試行された新しい配信です。response_statusは今回エンドポイントが返した値です(504はタイムアウト、503は接続失敗)。元の配信は変更されません。

Webhookの送信先への配信試行1件。Diditが送信したリクエストヘッダーと本文をそのまま含みます。

uuid
string<uuid>
必須

配信ID。詳細取得と再送の呼び出しに使用します。

session_id
string<uuid> | null
必須

イベントの対象となるユーザー認証セッション。企業セッション、ユーザー、企業、取引、トラベルルール、ワークフローのイベントではnullです。

request_url
string<uri> | null
必須

配信の送信先URL。イベント生成時点の送信先のURLです。

response_status
integer | null
必須

エンドポイントが返したHTTPステータス。配信がキューに入っていてまだ試行されていない間はnullです。HTTP応答を受信しなかった場合、Diditは独自のステータスを記録します。エンドポイントが5秒以内に応答しなかった場合は504、接続に失敗した場合は503、URLが安全でないとして拒否された場合(プライベートアドレスや内部アドレスなど)は400、その他のリクエストエラーの場合は404です。400以上は配信失敗とみなされます。

response_time_ms
integer | null
必須

試行にかかった時間(ミリ秒)。配信がキューに入っている間はnullです。

必須範囲: x >= 0
status
string | null
必須

イベント生成時に報告されたステータス。セッションイベントではセッションのステータス(例: ApprovedやIn Review)、ユーザーイベントと企業イベントでは個人または企業のステータス、取引イベントでは取引のステータスです。ステータスを持たないイベントではnullです。

webhook_type
enum<string>
必須

サポートされているWebhookイベント名。subscribed_eventsではこれらの文字列を正確に使用してください。サポートされていない値は拒否されます。

利用可能なオプション:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
created_at
string<date-time>
必須

配信が作成された日時。

request_header
string
必須

Diditが送信したリクエストヘッダー(Content-Type、X-Signature、X-Signature-V2、X-Signature-Simple、X-Timestamp、User-Agent)のJSONテキスト(文字列)です。JSONパーサーで解析してください。署名は含まれますが、署名用シークレットは決して含まれません。

request_body
string
必須

Diditが送信したペイロードそのもののJSONテキスト(文字列)です。キーはソートされ、event_idとtimestampを含みます。JSONパーサーで解析してください。ペイロードの形式を参照してください。media: readを持たないスコープ付きキーの場合、その中のメディアURLはnullになります。sessions: writeを持たない場合、セッショントークンとホスト型検証リンクはnullになります。このように変更された本文は、署名と一致しなくなります。Diditは、お使いのエンドポイントが返したレスポンス本文を記録しません。

最終更新日 2026年11月1日