Webhooks - ffmpeg-api-cloud

ジョブ状態を継続的にポーリングしたくない場合は webhook を使います。

仕組み

ジョブ作成時に webhookUrl を送信します。
API が FFmpeg または FFprobe ジョブを非同期で実行します。
完了時に、署名付きイベントがあなたのエンドポイントに送信されます。

webhook 付きジョブを作成する

curl -X POST https://ffmpeg-api.cloud/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "binary": "ffprobe",
    "webhookUrl": "https://your-app.example.com/webhooks/ffmpeg",
    "input": [
      {
        "type": "url",
        "url": "https://example.com/input.mp4"
      }
    ],
    "ffmpegArgs": [
      "-v",
      "error",
      "-show_format",
      "-show_streams",
      "-of",
      "json",
      "input0"
    ]
  }'

webhook エンドポイントをテストする

curl -X POST https://ffmpeg-api.cloud/v1/webhooks/test \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.example.com/webhooks/ffmpeg"
  }'

次へ

認証方式とレスポンス規約は /ja/api-reference/overview を参照してください。
正確なフィールド構造は自動生成された API ページを参照してください。