VOD Stationの概要

Prev Next

Classic/VPC環境で利用できます。

VOD Stationは、保存された動画をさまざまなデバイスで視聴できるように変換するエンコード機能や動画ファイルをパケット化することで、ネットワークの効率的な使用が可能なストリーミング機能を提供する NAVERクラウドプラットフォームの VOD専用サービスです。VOD Stationサービスは、映像のエンコードとストリーミング機能を RESTful API形式で提供します。

VOD Stationの共通設定

VOD Station APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

https://vodstation.apigw.ntruss.com

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-timestamp Required 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
  • Unix Timestamp形式
x-ncp-iam-access-key Required NAVERクラウドプラットフォームから発行された Access Key
x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名
Content-Type Optional リクエストデータの形式
  • application/json
x-ncp-region_code Optional リージョンコード
  • KR: 韓国 (有効値)

レスポンス

共通レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

error

errorは API呼び出し失敗情報を定義します。errorの説明は次の通りです。

フィールド タイプ 必須の有無 説明
error Object - エラーコードとメッセージ
error.errorCode String Required エラーコード
error.message String Required エラーメッセージ
error.details String Required エラーメッセージの詳細

レスポンスステータスコード

VOD Station APIで共通して使用されるレスポンスステータスコードの詳細は、次をご参照ください。

レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

{
    "error": {
        "errorCode": "300",
        "message": "Not Found Exception"
    }
}

VOD Station API

VOD Stationサービスで提供する APIの説明は次の通りです。

Channel

Channel関連 APIの説明は次の通りです。

API 説明
チャンネルの作成 VODストリーミングチャンネルを作成
チャンネルリストの照会 VODストリーミングチャンネルリストを照会
チャンネルイベントの照会 VODストリーミングチャンネルで発生したイベントを照会
チャンネルの照会 VODストリーミングチャンネルの詳細情報を照会
プロトコルリストの照会 サポートするストリーミングプロトコルを照会
チャンネルの開始 VODストリーミングチャンネルを開始
チャンネルの停止 VODストリーミングチャンネルを停止
チャンネル CDNの変更 VODストリーミングチャンネル CDNを変更
チャンネルの削除 VODストリーミングチャンネルを削除

Category

Category関連 APIの説明は次の通りです。

API 説明
カテゴリの作成 映像ファイルエンコードのためのカテゴリを作成
カテゴリリストの照会 2つ以上のカテゴリリストを照会
カテゴリの照会 カテゴリの詳細情報を照会
カテゴリの更新 カテゴリの詳細情報を更新
カテゴリにファイルを追加 カテゴリにエンコードファイルを追加
カテゴリの削除 作成したカテゴリを削除
カテゴリコールバックの使用 エンコードリクエスト状態を確認するためのコールバック使用を設定

Encoding Option

Encoding Option関連 APIの説明は次の通りです。

API 説明
エンコードオプションの作成 映像ファイル変換のためのエンコードオプションを作成
エンコードオプションリストの照会 2つ以上のエンコードオプションリストを照会
エンコードオプションの照会 エンコードオプションの詳細情報を照会
エンコードオプションテンプレートリストの照会 2つ以上のエンコードテンプレートリストを照会
エンコードオプションの削除 作成したエンコードオプションを削除

Status

Status関連 APIの説明は次の通りです。

API 説明
カテゴリ状態リストの照会 カテゴリ別エンコード状態リストを照会
カテゴリ状態の照会 カテゴリエンコード状態の詳細情報を照会
カテゴリ統計の照会 カテゴリファイルエンコード統計を照会

VOD Station関連リソース

VOD Station APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。