チャンネルの作成

VOD Stationと連携された Global Edgeのコンテンツ認証(Signed URL/JWT)制御使用時の注意事項は次の通りです。

Global Edgeのキャッシュ設定の際は、Edge Authを以下のように設定します。Global Edge Edge Auth設定の変更方法の詳細は、APIガイドをご参照ください。
- 認証除外拡張子
  - .ts, .mp4, .m4s, .vtt, .key
- 認証トークンをソースに伝達する拡張子
  - .m3u8, .mpd
認証トークン発行の際は、SignedURLに acl入力フィールド、JWTに path入力フィールドがあり、それぞれに wildcard pathを入力します。認証トークン発行方法の詳細は、ご利用ガイドをご参照ください。
- 単一ビットレートの再生: '/[protocol]/[encryptedBucketName]/[path]/[video filename]/*'
  - 例)
    - HLS : https://example.edge.navercorp.com/hls/guide/vod-5100k.mp4/index.m3u8
      - wildcard path : '/hls/guide/vod-5100k.mp4/*'
    - DASH : https://example.edge.navercorp.com/dash/guide/vod-5100k.mp4/index.m3u8
      - wildcard path : '/dash/guide/vod-5100k.mp4/*'
- Adaptiveビットレートの再生: '/[protocol]/[encryptedBucketName]/[path]/[prefix],[video filenames],[suffix].smil/*'
  - 例)
    - HLS再生アドレス: https://example.edge.navercorp.com/hls/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/master.m3u8
      - wildcard path : '/hls/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/*'
    - DASH再生アドレス: https://example.edge.navercorp.com/dash/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/manifest.mpd
      - wildcard path : '/dash/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/*'

リクエスト

POST https://vodstation.apigw.ntruss.com/api/v2/channels

リクエストヘッダ

ヘッダ名	説明
x-ncp-region_code	NAVERクラウドプラットフォームの region code `x-ncp_region_code:{Region Code}`
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-v2	Access Key IDと Secret Keyで暗号化した署名 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	Request body content typeは application/jsonに指定 `Content-Type: application/json`

ヘッダ名

説明

x-ncp-region_code

NAVERクラウドプラットフォームの region code
x-ncp_region_code:{Region Code}

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-v2

Access Key IDと Secret Keyで暗号化した署名
x-ncp-apigw-signature-v2:{API Gateway Signature}

Content-Type

Request body content typeは application/jsonに指定
Content-Type: application/json

リクエストボディ

APIリクエスト時はフィールド名の大文字、小文字の区別が必要です。

レスポンス

例

リクエスト例

POST https://vodstation.apigw.ntruss.com/api/v2/channels POST /api/v2/channels HOST: vodstation.apigw.ntruss.com Content-Type: application/json x-ncp-region_code:KR x-ncp-apigw-timestamp:1521787414578 x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M= Request body (Global Edge) { "accessPrivateFiles": false, "cdn": { "profileId": 681, "regionType": "KOREA", "type": "GLOBAL_EDGE" }, "createCdn": true, "name": "ey-api-gedge-0628", "protocolList": [ "HLS","DASH" ], "segmentDuration": 5, "segmentDurationOption": "BASIC", "storageBucketName": "eytestbucket" } Reqeust body (non DRM) { "cdnTypeList": [ "CDN+" ], "name": "api-guide", "protocolList": [ "HLS", "DASH" ], "segmentDuration": 5, "storageBucketName": "vodstation-bucket" } Request body (One Click Multi DRM using MediaEncryption and Widevine/PlayReady) { "createCdn": true, "name": "api-guide-drm", "protocolList": [ "HLS", "DASH" ], "segmentDuration": 5, "segmentDurationOption": "BASIC", "accessPrivateFiles": true, "storageBucketName": "vodstaton-test", "drm" : { "siteId" : "ABCD", "contentId" : "abc-2344-dfd" } } Request body (DRM using MediaEncryption and Widevine/PlayReady) { "cdn": { "profileId": 681, "regionType": "KOREA", "type": "GLOBAL_EDGE" }, "createCdn": true, "encryptionList": [ { "drmContentId": "openapi", "drmKeyUrl": "https://kms.example.com/cpix/token", "systemIdList": [ "9A04F079-9840-4286-AB92-E65BE0885F95", "EDEF8BA9-79D6-4ACE-A3C8-27DCD51D21ED" ], "drmTypeCode": 22, "protocol": "DASH" }, { "mediaEncryptTypeCode": 1, "protocol":"HLS" } ], "name": "api-guide-drm", "protocolList": [ "HLS", "DASH" ], "segmentDuration": 5, "segmentDurationOption": "BASIC", "accessPrivateFiles": true, "storageBucketName": "vodstaton-test" } Request body (DRM using FairPlay and Widevine/PlayReady) { "cdn": { "profileId": 681, "regionType": "KOREA", "type": "GLOBAL_EDGE" }, "createCdn": true, "encryptionList": [ { "drmContentId": "openapi", "drmKeyUrl": "https://kms.example.com/cpix/token", "systemIdList": [ "9A04F079-9840-4286-AB92-E65BE0885F95", "EDEF8BA9-79D6-4ACE-A3C8-27DCD51D21ED" ], "drmTypeCode": 22, "protocol": "DASH" }, { "drmContentId": "openapi", "drmKeyUrl": "https://kms.example.com/cpix/token", "systemIdList": [ "94CE86FB-07FF-4F43-ADB8-93D2FA968CA2" ], "drmTypeCode": 21, "protocol": "HLS" }, ], "name": "api-guide-drm", "protocolList": [ "HLS", "DASH" ], "segmentDuration": 5, "accessPrivateFiles": true, "storageBucketName": "vodstaton-test" } Request body (DRM using Widevine) { "cdn": { "profileId": 681, "regionType": "KOREA", "type": "GLOBAL_EDGE" }, "createCdn": true, "encryptionList": [ { "drmContentId": "openapi", "drmKeyUrl": "https://kms.example.com/cpix/token", "systemIdList": [ "EDEF8BA9-79D6-4ACE-A3C8-27DCD51D21ED" ], "drmTypeCode": 22, "protocol": "DASH" }, ], "name": "api-guide-drm", "protocolList": [ "HLS", "DASH" ], "segmentDuration": 5, "accessPrivateFiles": true, "storageBucketName": "vodstaton-test" } Request body (using MediaEncryption Only) { "cdn": { "profileId": 681, "regionType": "KOREA", "type": "GLOBAL_EDGE" }, "createCdn": true, "encryptionList": [ { "mediaEncryptTypeCode": 1, "protocol":"HLS" } ], "name": "api-guide-drm", "protocolList": [ "HLS", "DASH" ], "segmentDuration": 5, "accessPrivateFiles": true, "storageBucketName": "vodstaton-test" }

レスポンス例

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": { "disabled": false, "id": "vs-20230628104743-IhwvCgd", "name": "ey-api-gedge-0628", "channelStatus": "CREATING", "storageBucketName": "gjtest", "segmentDuration": 5, "protocolList": [ "HLS", "DASH" ], "createTime": 1687916863, "cdnCreatedTime": 1687916864, "playUrl": "https://kphmlswg1388.beta-edge.naverncp.com/[protocol]/[Object Storage Bucket(encryption name)]/[path]/[video filename]/[manifest]", "cdnStatus": "CREATING", "cdnDomain": "kphmlswg1388.beta-edge.naverncp.com", "cdnServiceName": "edge-vs-20230628104743-IhwvCgd", "storageBucketStatus": "RUNNING", "originPath": "beta-vs2-k1.video.media.ntruss.com/86/vs-20230628104743-IhwvCgd", "encryptList": [ ], "accessPrivateFiles": false, "encryptedBucketName": "sk3DDQr8sR~23I9msiHAPg__", "segmentDurationOption": "BASIC", "cdn": { "cdnType": "GLOBAL_EDGE", "cdnDomain": "kphmlswg1388.beta-edge.naverncp.com", "cdnServiceName": "edge-vs-20230628104743-IhwvCgd", "profileId": 681, "regionType": "KOREA", "cdnInstanceNo": 1388 }, "drm": { "siteId": "ABCD", "contentId": "abc-2344-dfd" } } }