動画が終了したときに通知を受け取る

このトピックでは、Zencoder ジョブが完了したときに通知を取得する方法を説明します。

概要

ジョブまたは出力ファイルの完了後、いくつかの方法でそれについて調べることができます。

私たちは、詳細をあなたのアプリケーションにHTTPリクエストをPOSTすることができます。
ngrok などのサードパーティツールを使用して通知をリクエストできます。これは、ローカルで開発していて Zencoder が開発サーバーにアクセスできない場合に便利です。
私たちはメールを送ることができます。
Zencoder ダッシュボードでジョブの状態を確認できます。

HTTP/メール通知を受け取る

HTTPまたは電子メール通知を受信するには、次を追加します通知オプション次のように、APIリクエストに追加します。

{
  "api_key": "93h630j1dsyshjef620qlkavnmzui3",
  "input": "s3://bucket-name/file-name.avi",
  "notifications": [
  "http://user:password@example.com/zencoder",
  "admin@example.com"
  ],
  "outputs": [
  {
      "label": "web",
      "url": "s3://output-bucket/web.mp4",
      "size": "512x384",
      "notifications": [
      "http://user:password@example.com/zencoder",
      "admin@example.com"
      ]
  },
  {
      "label": "iphone",
      "url": "s3://output-bucket/iphone.m4v",
      "size": "480x320",
      "notifications": [
      {"format": "xml", "url": "http://user:password@example.com/zencoder1"},
      {"format": "json", "url": "http://user:password@example.com/zencoder2"},
      "http://example.com/zencoder3",
      "admin@example.com"
      ]
  }
  ]
}

この例では、最初の出力ファイルが完了すると、2 つの通知が送信されます。

admin@example.com出力および入力/ジョブに関する情報を宛てに電子メールで送信してください。
HTTP POST をhttp://user:password@example.com/zencoder Content-Type ヘッダーに「application/json' 」に設定し、出力と入力/ジョブに関する情報を表示します。

2 番目の出力ファイルが完了すると、さらに 4 つの通知が送信されます。

HTTP POST をhttp://example.com/zencoder1 Content-Type ヘッダーを 'application/xml' に設定し、出力と入力に関する情報を含めます。
HTTP POST をhttp://example.com/zencoder2 Content-Type ヘッダーに「application/json' 」に設定し、出力と入力/ジョブに関する情報を表示します。
admin@example.com出力および入力/ジョブに関する情報を宛てに電子メールで送信してください。
HTTP POST をhttp://example.com/zencoder3 Content-Type ヘッダーに「application/json' 」に設定し、出力と入力/ジョブに関する情報を表示します。

ジョブが完了すると、さらに 2 つの通知が送信されます。

admin@example.com出力と入力に関する情報を宛てに電子メールで送信してください。
HTTP POST をhttp://user:password@example.com/zencoder Content-Type ヘッダーに「application/json' 」に設定し、出力と入力に関する情報を含めます。

注:通知の送信時に Zencoder がターゲットサーバーに正常に接続できない場合、通知はキューに入れられて再試行されます。通知は最大20回試行され、試行間の遅延は毎回倍増します。

HTTP 通知

通知には、ジョブおよび入出力ファイルに関する多くの情報を含むリッチコンテンツが含まれます。通知の本文には、JSON または XML を含めることができます。アップロードが失敗した場合、通知には、使用されたエラーおよびバックアップサーバーに関する情報も含まれます。

求人通知の例

{
  "outputs":[
  {
      "height":120,
      "audio_sample_rate":8000,
      "frame_rate":8.0,
      "channels":"1",
      "duration_in_ms":1920,
      "video_bitrate_in_kbps":70,
      "video_codec":"h264",
      "format":"mpeg4",
      "audio_codec":"aac",
      "label":null,
      "file_size_in_bytes":17938,
      "width":160,
      "audio_bitrate_in_kbps":9,
      "id":235314,
      "total_bitrate_in_kbps":79,
      "state":"finished",
      "url":"ftp://example.com/file.mp4",
      "md5_checksum":"7f106918e02a69466afa0ee014172496",
      "thumbnails": [
      {
          "label":"poster",
          "images":
          [
          {
              "url": "ftp://example.com/images/123.png",
              "format": "PNG",
              "file_size_bytes": 1273573,
              "dimensions": "1280x720"
          }
          ]
      }
      ]
  },
  {
      "height":120,
      "audio_sample_rate":8000,
      "frame_rate":8.0,
      "channels":"1",
      "duration_in_ms":1920,
      "video_bitrate_in_kbps":70,
      "video_codec":"h264",
      "format":"mpeg4",
      "audio_codec":"aac",
      "label":null,
      "file_size_in_bytes":17938,
      "width":160,
      "audio_bitrate_in_kbps":9,
      "id":235314,
      "total_bitrate_in_kbps":79,
      "state":"finished",
      "url":"ftp://example.com/file.mp4",
      "md5_checksum":"7f106918e02a69466afa0ee014172496",
      "thumbnails": [
      {
          "label":"poster",
          "images":
          [
          {
              "url": "ftp://example.com/images/123.png",
              "format": "PNG",
              "file_size_bytes": 1273573,
              "dimensions": "1280x720"
          }
          ]
      }
      ]
  }
  ],
  "job":{
      "created_at":"2011-09-27T04:20:10Z",
      "pass_through":null,
      "updated_at":"2011-09-27T04:21:18Z",
      "submitted_at":"2011-09-27T04:20:10Z",
      "id":172151,
      "state":"finished"
  },
  "input":{
      "height":120,
      "audio_sample_rate":8000,
      "frame_rate":8.0,
      "channels":"1",
      "duration_in_ms":1552,
      "video_bitrate_in_kbps":32,
      "video_codec":"mpeg4",
      "format":"mpeg4",
      "audio_codec":"aac",
      "file_size_in_bytes":13960,
      "width":160,
      "audio_bitrate_in_kbps":9,
      "id":172149,
      "state":"finished",
      "total_bitrate_in_kbps":41,
      "md5_checksum":"7f106918e02a69466afa0ee014174143"
  }
}

出力通知の例

{
  "output":{
      "height":120,
      "audio_sample_rate":8000,
      "frame_rate":8.0,
      "channels":"1",
      "duration_in_ms":1920,
      "video_bitrate_in_kbps":70,
      "video_codec":"h264",
      "format":"mpeg4",
      "audio_codec":"aac",
      "label":null,
      "file_size_in_bytes":17938,
      "width":160,
      "audio_bitrate_in_kbps":9,
      "id":235314,
      "total_bitrate_in_kbps":79,
      "state":"finished",
      "url":"ftp://example.com/file.mp4",
      "md5_checksum":"7f106918e02a69466afa0ee014172496",
      "thumbnails":
      [
      {
          "label":"poster",
          "images":
          [
          {
              "url": "ftp://example.com/images/123.png",
              "format": "PNG",
              "file_size_bytes": 1273573,
              "dimensions": "1280x720"
          }
          ]
      }
      ]
  },
  "job":{
      "created_at":"2011-09-27T04:20:10Z",
      "pass_through":null,
      "updated_at":"2011-09-27T04:21:18Z",
      "submitted_at":"2011-09-27T04:20:10Z",
      "id":172151,
      "state":"finished"
  },
  "input":{
      "height":120,
      "audio_sample_rate":8000,
      "frame_rate":8.0,
      "channels":"1",
      "duration_in_ms":1552,
      "video_bitrate_in_kbps":32,
      "video_codec":"mpeg4",
      "format":"mpeg4",
      "audio_codec":"aac",
      "file_size_in_bytes":13960,
      "width":160,
      "audio_bitrate_in_kbps":9,
      "id":172149,
      "state":"finished",
      "total_bitrate_in_kbps":41,
      "md5_checksum":"7f106918e02a69466afa0ee014174143"
  }
}