プラットフォーム
Webhook（ウェブフック）
Webhook（ウェブフック）とは、非同期のジョブが完了したときに、プラットフォームがあなたのサーバーに送る署名付きのHTTPコールバックです。ポーリングが不要になります。数分かかる動画生成は、その代表的な用途です。
署名があることで、受信側はペイロードが本当にそのプラットフォームから送られたものかを検証できます。
eroqでは
video.generation.succeeded／failedのイベントを、Stripe方式のeroq-signatureヘッダー付きで送信します。設定は開発者ダッシュボードで行います。
よくある質問
Webhookは必ず使う必要がありますか？
いいえ。GET /v1/videos/generations/{id}をポーリングする方法でも大丈夫です。
eroqが送信するイベントは？
video.generation.succeededとvideo.generation.failed、それにダッシュボードから自分で送信できるテストイベントです。画像、音声合成、チャットはリクエストそのものに応答が返るので、コールバックで知らせることはありません。
eroqのWebhookを検証するには？
署名を再計算してください。eroq-signatureヘッダーには、タイムスタンプと16進数のダイジェストが含まれています。これは、タイムスタンプ、ドット、生のリクエストボディをつなげたものに対するHMAC-SHA256で、キーにはエンドポイント作成時に一度だけ表示されるシークレットを使います。