Guide
Job完了を待つ
小規模な確認にはPolling、本番の継続処理にはWebhookを使い、同じJob状態を正本にします。
Choose a strategy
| 方式 | 利用場面 | 実装上の要点 |
|---|---|---|
Polling | 開発・管理画面・短い確認 | 間隔を広げ、上限を持つ |
Webhook | 本番の非同期連携 | 署名、重複、再送を処理 |
Polling
Preview polling
let delay = 2000;while (true) { const job = await fetch("https://api.virafy.example/v1/jobs/job_preview_01").then((r) => r.json()); if (["succeeded", "failed"].includes(job.status)) break; await new Promise((resolve) => setTimeout(resolve, delay)); delay = Math.min(delay * 1.5, 15000);}無限に待たない
最大待機時間、キャンセル、再開位置を呼び出し側で持ちます。