POST リクエストが届きます。
配信には自動リトライと指数バックオフが含まれます。
Webhook 送信先のセットアップが必要ですか？はじめにの手順に従ってください。
要件
Webhook エンドポイントは以下の要件を満たす必要があります：| 要件 | 詳細 |
|---|---|
| HTTPS | 送信先 URL は HTTPS を使用すること |
| 200 レスポンス | 受信確認として 30 秒以内に 200 ステータスを返すこと |
| 冪等性 | 重複配信を処理すること — イベントタイプごとの重複排除戦略は Webhook 処理ガイド を参照 |
イベントタイプ
すべての送信先は自動的にすべてのイベントタイプを受信します。イベントごとのフィルタリングはありません。state_change
サービスリクエストのステータス変更 — 品質管理、鑑定の進捗、最終結果。
media_rejected
アップロードされた画像が品質管理で拒否された。
invalidate_sr
サービスリクエストがキャンセルまたは処理不能。
共通ペイロードフィールド
すべての Webhook イベントに以下の基本フィールドが含まれます：| フィールド | 型 | 説明 |
|---|---|---|
event_type | string | イベント識別子（state_change、media_rejected、invalidate_sr） |
sr_uuid | string | サービスリクエスト UUID |
reference_id | string | null | 貴社の内部商品 ID（サービスリクエスト作成時に設定した external_id） |
timestamp | string | イベント発生時の ISO 8601 タイムスタンプ |
リトライ
配信失敗（非 2xx レスポンスまたはタイムアウト）は指数バックオフで自動リトライされます：| 試行回数 | 遅延 |
|---|---|
| 1 | 即時 |
| 2 | 約 5 秒 |
| 3 | 約 5 分 |
| 4 | 約 30 分 |
| 5 | 約 2 時間 |