チャンネルの作成

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

Live Stationの VODチャンネルを作成する APIです。作成したチャンネルを照会するためのチャンネルリスト照会APIとチャンネル情報照会APIを提供します。

コンテンツ保護設定

Live Station DRM Encryptionはリアルタイムコンテンツの Multi DRMをサポートします。
チャンネル作成内の DRM設定領域て簡単に DRM機能を設定できます。選択した OutputProtocolに応じて Multi DRM Encryptionをサポートします。
DRM技術別暗号化方式と対応する端末、他のプラットフォームとバージョンの詳細は、リンクをご参照ください。

DRMタイプ
- FairPlay: Appleで提供する DRM技術規格です。各 HLSセグメントを AES-CBC方式で暗号化します。
- Widevine: Googleで提供する DRM技術規格です。Common Encryption規格に沿って AES-128方式で暗号化します。
- PlayReady: Microsoftで提供する DRM技術規格です。Common Encryption規格に沿って AES-128方式で暗号化します。

リクエスト

POST https://livestation.apigw.ntruss.com/api/v2/vod/channels

リクエストヘッダ

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

リクエストボディ

フィールド名	必須の有無	タイプ	制限事項	説明
channelName	Yes	String	3~20文字以内で入力可能記号の「_」を使用可能	作成するチャンネルの名前
outputProtocol	Optional	String	HLS HLS、DASH LL_HLS	出力プロトコル設定入力しない場合、HLSに設定される
envType	Optional	String	DEV、STAGE、REAL	作成するチャンネルの使用区分のための設定入力しない場合は REALに設定される
cdn	Yes	Object		CDN Object
cdn.createCdn	Yes	Boolean	true、false	CDN Object
cdn.cdnType	Yes	String	GLOBAL_CDN、GLOBAL_EDGE	CDN+はサポートしない
cdn.profileId	Yes	Integer		GLOBAL_EDGE新規作成時に必要な Global Edgeのプロファイル
cdn.regionType	Yes	String	KOREA、JAPAN、GLOBAL	Global Edgeのサービス地域
cdn.cdnInstanceNo	Optional	Integer		cdn.createCdnが falseの場合、必ず設定
qualitySetId	Yes	Integer
drmEnabledYn	Yes	Boolean		DRM Encryption設定の適用有無
drm	Optional	Object		Live Stationを利用した DRM Encryption設定 DRM設定時、FairPlay、Widevine/PlayReady DRMをサポート
drm.siteId	Optional	String		One Click Multi DRMサービスで作成した site id
drm.contentId	Optional	String		DRM Encryption適用対象コンテンツの固有 ID DRMパッケージングに使用され、英数字、記号の「-」(ハイフン)、「_」(アンダースコア)のみ使用して3~100文字以内で入力できます。

レスポンス

フィールド名	タイプ	説明	備考
channelId	String
channelName	String
outputProtocol	String	HLS HLS、DASH LL_HLS
envType	String	DEV、STAGE、REAL
cdn	Object
cdn.createCdn	Boolean
cdn.cdnType	String	GLOBAL_CDN、GLOBAL_EDGE
cdn.profileId	Integer	GLOBAL_EDGE新規作成時に必要な Global Edgeのプロファイル
cdn.regionType	String	Global Edgeのサービス地域	KOREA、JAPAN、GLOBAL
cdn.cdnInstanceNo	Integer		cdn.createCdnが falseの場合、必ず設定
qualitySetId	Integer
type	String
drmEnabledYn	Boolean	DRM Encryption設定の適用有無
drm	Object	Live Stationを利用した DRM Encryption設定 DRM設定時、FairPlay、Widevine/PlayReady DRMをサポート
drm.siteId	String	One Click Multi DRMサービスで作成した site id
drm.contentId	String	DRM Encryption適用対象コンテンツの固有 ID DRMパッケージングに使用され、英数字、記号の「-」(ハイフン)、「_」(アンダースコア)のみ使用して3~100文字以内で入力できます。

例

リクエスト例

POST /api/v2/vod/channels
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR

Request body (if cdn.createCdn == true)
{
  "channelName": "myTestChannel",
  "cdn": {
    "createCdn": true,
    "cdnType": "GLOBAL_EDGE"
  },
  "qualitySetId": 5,
  "envType": "REAL",
  "outputProtocol": "HLS",
  "drmEnabledYn": true,
  "drm": {
    "siteId": "drm-20231115142326-nHyNw",
    "contentId": "my-Test-Multidrm"
  }
}

Request body (if cdn.createCdn == false)
{
    "channelName": "myTestChannel",
    "cdn": {
      "createCdn": false,
      "cdnType": "GLOBAL_EDGE",
      "cdnDomain": "mycdn.edge.naverncp.com",
      "profileId": 299,
      "cdnInstanceNo": 1541959,
      "regionType": "KOREA"
    },
    "qualitySetId": 4,
    "envType": "REAL",
    "outputProtocol": "HLS",
    "drmEnabledYn": true,
    "drm": {
        "siteId": "drm-20231115142326-nHyNw",
        "contentId": "my-Test-Multidrm"
    }
}

レスポンス例

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Feb 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": {
    "channelName": "myTestChannel",
    "cdn": {
      "createCdn": false,
      "cdnType": "GLOBAL_EDGE",
      "cdnDomain": "mycdn.edge.naverncp.com",
      "profileId": 299,
      "cdnInstanceNo": 1541959,
      "regionType": "KOREA"
    },
    "qualitySetId": 4,
    "envType": "REAL",
    "outputProtocol": "HLS",
    "channelId": "ls-20211122220557-mUv3r",
    "type": "VOD",
    "drmEnabledYn": true,
    "drm": {
        "siteId": "drm-20231115142326-nHyNw",
        "contentId": "my-Test-Multidrm"
    }
  }
}

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

What's Next

チャンネルの削除

リクエスト
レスポンス
例

タグ

Live Station