Webhooks - ffmpeg-api-cloud

Utilisez les webhooks si vous ne voulez pas interroger en continu l’état du job.

Fonctionnement

Envoyez webhookUrl lors de la création du job.
L’API exécute le job FFmpeg ou FFprobe de manière asynchrone.
Votre endpoint reçoit un événement signé à la fin du traitement.

Créer un job avec 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"
    ]
  }'

Tester votre endpoint 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"
  }'

Ensuite

Consultez /fr/api-reference/overview pour l’authentification et les conventions de réponse.
Consultez les pages API générées pour les champs et payloads exacts.