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"
  }'

다음

인증 방식과 응답 규칙은 /ko/api-reference/overview 를 참고하세요.
정확한 필드와 payload 구조는 생성된 API 페이지를 참고하세요.