サポートに連絡する| システムステータス
ページコンテンツ

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

    このトピックでは、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"
      }
    }

    ページの最終更新日14 Oct 2021