Skip to main content
Legitmark は Webhook を通じて、HTTPS エンドポイントにリアルタイムのイベント通知を送信します。サービスリクエストのステータスが変更されたとき、品質管理で画像が拒否されたとき、またはリクエストが無効化されたとき、エンドポイントにイベントペイロードを含む POST リクエストが届きます。 配信には自動リトライと指数バックオフが含まれます。
Webhook 送信先のセットアップが必要ですか?はじめにの手順に従ってください。

要件

Webhook エンドポイントは以下の要件を満たす必要があります:

イベントタイプ

すべての送信先は自動的にすべてのイベントタイプを受信します。イベントごとのフィルタリングはありません。

state_change

サービスリクエストのステータス変更 — 品質管理、鑑定の進捗、最終結果。

media_rejected

アップロードされた画像が品質管理で拒否された。

invalidate_sr

サービスリクエストがキャンセルまたは処理不能。

共通ペイロードフィールド

すべての Webhook イベントに以下の基本フィールドが含まれます:

リトライ

配信失敗(非 2xx レスポンスまたはタイムアウト)は指数バックオフで自動リトライされます: すべてのリトライが尽きると、メッセージは失敗としてマークされます。配信状況の確認と手動リトライは Legitmark ダッシュボードから行えます。

テスト

エンドポイントがまだ準備できていない場合は、Svix Play を使用してテスト用の一時的な Webhook URL を生成できます。生成された URL を開発者設定に Webhook 送信先として貼り付け、テストイベントを送信して、リアルタイムでペイロードを確認してください。

次のステップ

イベントタイプ

各イベントタイプの詳細なペイロード構造。

Webhook 処理ガイド

コード例、ベストプラクティス、セキュリティガイダンス。