Create channel
- Print
- PDF
Create channel
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
The latest service changes have not yet been reflected in this content. We will update the content as soon as possible. Please refer to the Korean version for information on the latest updates.
An API to create VOD channels of Live Station. Channel list view API and Channel information view API are provided to view the created channels.
Content protection settings
Live Station's DRM Encryption supports the multi-DRM of real-time content.
You can easily set DRM functions in DRM Settings within the created channel. Multi DRM Encryption is supported according to the selected outputProtocol.
For details on the encryption method and supported device for each DRM technology and other platforms and versions, see Link.
Encryption method | Protocol | DRM type | Encryption algorithm | Supported devices |
---|---|---|---|---|
DRM | HLS | FairPlay | AES-CBC | Mac/iOS Safari browser, iOS/iPadOS/tvOS app, HLS HTML5 |
DRM | DASH | PlayReady, Widevine | CENC (Common Encryption) | MS Edge, Internet Explorer 11, Google Chrome, Firefox, Opera DASH HTML5 |
- DRM type
- FairPlay: DRM technical specifications provided by Apple. It encrypts each HLS segment by using AES-CBC method.
- Widevine: DRM technical specifications provided by Google. It uses the AES-128 method for encryption according to the common encryption specifications.
- PlayReady: DRM technical specifications provided by Microsoft. It uses the AES-128 method for encryption according to the common encryption specifications.
Requests
POST https://livestation.apigw.ntruss.com/api/v2/vod/channels
Request headers
Header name | Requirement status | Description |
---|---|---|
x-ncp-apigw-timestamp | YES | It indicates the time elapsed since January 1, 1970, 00:00:00 UTC in milliseconds, and the request is considered invalid if the time difference from the API Gateway server is 5 minutes or longerx-ncp-apigw-timestamp:{Timestamp} |
x-ncp-iam-access-key | YES | Value of access key ID issued in the NAVER Cloud Platform portalx-ncp-iam-access-key:{Sub Account Access Key} |
x-ncp-apigw-signature-v2 | YES | Signature encrypted with the access key ID value and secret keyx-ncp-apigw-signature-v2:{API Gateway Signature} |
Content-Type | YES | Specifies the request body content type as application/jsonContent-Type: application/json |
x-ncp-region_code | YES | Region code (KR) |
Request body
Field name | Requirement status | Type | Restrictions | Description |
---|---|---|---|---|
channelName | Yes | String | This must be between 3 and 20 characters in length Underscores (_) allowed | Name of the channel to be created |
outputProtocol | Optional | String | HLS HLS,DASH LL_HLS | Output protocol settings Will be set to HLS if not entered |
envType | Optional | String | DEV, STAGE, REAL | Usage classification settings for the created channel Will be set to REAL if not entered |
cdn | Yes | Object | CDN Object | |
cdn.createCdn | Yes | Boolean | true, false | CDN Object |
cdn.cdnType | Yes | String | CDN_PLUS, GLOBAL_CDN,GLOBAL_EDGE | |
cdn.profileId | Yes | Integer | A Global Edge profile required when creating a new GLOBAL_EDGE | |
cdn.regionType | Yes | String | KOREA,JAPAN,GLOBAL | Global Edge service region |
cdn.cdnInstanceNo | Optional | Integer | This must be set if cdn.createCdn is false | |
qualitySetId | Yes | Integer | ||
drmEnabledYn | Yes | Boolean | Whether to apply DRM Encryption settings | |
drm | Optional | Object | DRM Encryption settings using Live Station When setting DRM, FairPlay and Widevine/PlayReady DRM are supported | |
drm.siteId | Optional | String | Site id created through One Click Multi DRM product | |
drm.contentId | Optional | String | Unique ID of content where DRM Encryption is applied Used for DRM packaging. You can enter 3 to 100 characters using English letters, numbers, hyphens (-), and underscores (_). |
Response
Field name | Type | Description | Remarks |
---|---|---|---|
channelId | String | ||
channelName | String | ||
outputProtocol | Optional | String | HLS HLS, DASH LL_HLS |
envType | String | DEV, STAGE, REAL | |
cdn | Object | ||
cdn.createCdn | Boolean | ||
cdn.cdnType | Yes | String | CDN_PLUS, GLOBAL_CDN,GLOBAL_EDGE |
cdn.profileId | Yes | Integer | |
cdn.regionType | Yes | String | KOREA,JAPAN,GLOBAL |
cdn.cdnInstanceNo | Optional | Integer | |
qualitySetId | Integer | ||
type | String | ||
drmEnabledYn | Boolean | Whether to apply DRM Encryption settings | |
drm | Object | DRM Encryption settings using Live Station When setting DRM, FairPlay and Widevine/PlayReady DRM are supported | |
drm.siteId | String | Site id created through One Click Multi DRM product | |
drm.contentId | String | Unique ID of content where DRM Encryption is applied Used for DRM packaging. You can enter 3 to 100 characters using English letters, numbers, hyphens (-), and underscores (_). |
Examples
Request example
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": "CDN_PLUS"
},
"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": "CDN_PLUS",
"cdnInstanceNo": 1541959
},
"qualitySetId": 4,
"envType": "REAL",
"outputProtocol": "HLS",
"drmEnabledYn": true,
"drm": {
"siteId": "drm-20231115142326-nHyNw",
"contentId": "my-Test-Multidrm"
}
}
Response example
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": "CDN_PLUS",
"cdnInstanceNo": 1541959
},
"qualitySetId": 4,
"envType": "REAL",
"outputProtocol": "HLS",
"channelId": "ls-20211122220557-mUv3r",
"type": "VOD",
"drmEnabledYn": true,
"drm": {
"siteId": "drm-20231115142326-nHyNw",
"contentId": "my-Test-Multidrm"
}
}
}
Was this article helpful?