カテゴリステータス情報の照会
    • PDF

    カテゴリステータス情報の照会

    • PDF

    記事の要約

    VOD Stationは、カテゴリのエンコード状態情報を照会するための APIを提供します。

    リクエスト

    GET https://vodstation.apigw.ntruss.com/api/v2/status/{fileId}
    

    リクエストヘッダ

    ヘッダ名説明
    x-ncp-apigw-timestamp- 1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表す
    - API Gatewayサーバとの時間差が5分以上の場合は、無効なリクエストとみなす
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-key- NAVERクラウドプラットフォームポータルから発行された Access Key ID値
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2Access Key ID値と Secret Keyで暗号化した署名
    x-ncp-apigw-signature-v2:{API Gateway Signature}

    レスポンス

    フィールド名タイプ説明備考
    errorObjectリクエスト失敗時のレスポンス
    エラーレスポンスコードとメッセージ
    error.codeIntegerエラーレスポンスコード
    error.messageStringエラーレスポンスメッセージ
    contentObjectVOD Station OPEN APIレスポンスオブジェクト
    content.categoryIdStringカテゴリ ID
    content.categoryNameStringカテゴリ名
    content.inputObject入力ファイルのオブジェクト
    content.input.fileIdInteger入力ファイル ID
    content.input.bucketNameString入力ファイルのバケット名
    content.input.filePathString入力ファイルのパス
    content.input.metadataObject入力ファイルのメタデータオブジェクト
    content.input.metadata.durationFloatファイル再生時間(単位: 秒)
    content.input.metadata.videoCodecStringビデオコーデック
    content.input.metadata.videoBitrateFloatビデオビットレート(単位: Kbps)
    content.input.metadata.profileStringビデオプロファイル
    content.input.metadata.widthIntegerビデオの幅
    content.input.metadata.heightIntegerビデオの高さ
    content.input.metadata.framerateStringビデオフレームレート
    content.input.metadata.audioCodecStringオーディオコーデック
    content.input.metadata.audioBitrateFloatオーディオビットレート(単位: Kbps)
    content.input.metadata.audioSamplingRateFloatオーディオサンプリングレート(単位: Hz)
    content.input.metadata.audioChannelIntegerオーディオチャンネル
    content.output[]Array(Object)出力ファイル情報
    content.output[].encodingOptionIdIntegerエンコードオプション ID
    content.output[].outputTypeStringアウトプットタイプ情報
    content.output[].objectStorageUrlStringObjectStorageダウンロード URL
    content.output[].fileSizeByteLong出力ファイルの容量(単位: byte)
    content.output[].statusStringエンコード結果の状態COMPLETE, WAITING, RUNNING, FAILURE, CANCELED
    content.output[].percentageIntegerエンコードの進捗率
    content.output[].metadataObject出力ファイルのメタデータ
    content.output[].metadata.durationFloatファイル再生時間(単位: 秒)
    content.output[].metadata.videoCodecStringビデオコーデック
    content.output[].metadata.videoBitrateFloatビデオビットレート(単位: Kbps)
    content.output[].metadata.videoPassStringビデオプロファイル
    content.output[].metadata.widthIntegerビデオの幅
    content.output[].metadata.heightIntegerビデオの高さ
    content.output[].metadata.framerateStringビデオフレームレート
    content.output[].metadata.audioCodecStringオーディオコーデック
    content.output[].metadata.audioBitrateFloatオーディオビットレート(単位: Kbps)
    content.output[].metadata.audioSamplingRateFloatオーディオサンプリングレート(単位: Hz)
    content.output[].metadata.audioChannelIntegerオーディオチャンネル

    リクエスト例

    GET https://vodstation.apigw.ntruss.com/api/v2/status/10099
    
    GET /api/v2/status/10099
    HOST: vodstation.apigw.ntruss.com
    x-ncp-apigw-timestamp:1521787414578
    x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
    x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M==
    

    レスポンス例

    HTTP/1.1 200 OK
    Server: nginx
    Date: Wed, 12 Sep 2018 09:53:32 GMT
    Content-Type: application/json;charset=utf-8
    Connection: keep-alive
    Access-Control-Allow-Origin: *
    x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
    
    {
      "content": {
        "categoryId": 10221,
        "categoryName": "openapi-guide",
        "input": {
          "fileId": 10099,
          "bucketName": "vodstation",
          "filePath": "openapi-guide.mov",
          "metadata": {
            "duration": 10.01,
            "videoCodec": "MPEG Video",
            "videoBitrate": 5871616,
            "width": 1280,
            "height": 720,
            "framerate": 59.94,
            "audioCodec": "PCM",
            "audioBitrate": 786432,
            "audioSamplingRate": 48000,
            "audioChannel": 1
          }
        },
        "output": [
          {
            "encodingOptionId": 3,
            "outputType": "AVC_HD_1Pass_30fps",
            "objectStorageUrl": "https://kr.object.ncloudstorage.com/test-vod/add-files-test/openapi-guide/openapi-guide_AVC_HD_1Pass_30fps.mp4",
            "status": "COMPLETE",
            "metadata": {
              "duration": 10.057,
              "videoCodec": "avc1",
              "videoPass": "ONE_PASS",
              "videoBitrate": 188416,
              "width": 1280,
              "height": 720,
              "framerate": 30,
              "audioCodec": "AAC",
              "audioBitrate": 131072,
              "audioSamplingRate": 44100,
              "audioChannel": 2
            }
          },
          {
            "encodingOptionId": 1,
            "outputType": "AVC_SD_1Pass_30fps",
            "objectStorageUrl": "https://kr.object.ncloudstorage.com/test-vod/add-files-test/openapi-guide/openapi-guide_AVC_SD_1Pass_30fps.mp4",
            "status": "COMPLETE",
            "metadata": {
              "duration": 10.057,
              "videoCodec": "avc1",
              "videoPass": "ONE_PASS",
              "videoBitrate": 195584,
              "width": 480,
              "height": 270,
              "framerate": 30,
              "audioCodec": "AAC",
              "audioBitrate": 131072,
              "audioSamplingRate": 44100,
              "audioChannel": 2
            }
          },
          {
            "encodingOptionId": 2,
            "outputType": "AVC_SD_1Pass_30fps_1",
            "objectStorageUrl": "https://kr.object.ncloudstorage.com/test-vod/add-files-test/openapi-guide/openapi-guide_AVC_SD_1Pass_30fps_1.mp4",
            "status": "COMPLETE",
            "metadata": {
              "duration": 10.057,
              "videoCodec": "avc1",
              "videoPass": "ONE_PASS",
              "videoBitrate": 253952,
              "width": 854,
              "height": 480,
              "framerate": 30,
              "audioCodec": "AAC",
              "audioBitrate": 131072,
              "audioSamplingRate": 44100,
              "audioChannel": 2
            }
          }
        ]
      }
    }
    

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.