Create channel
    • PDF

    Create channel

    • PDF

    Article Summary

    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 methodProtocolDRM typeEncryption algorithmSupported devices
    DRMHLSFairPlayAES-CBCMac/iOS Safari browser, iOS/iPadOS/tvOS app, HLS HTML5
    DRMDASHPlayReady, WidevineCENC (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 nameRequirement statusDescription
    x-ncp-apigw-timestampYESIt 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 longer
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyYESValue of access key ID issued in the NAVER Cloud Platform portal
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2YESSignature encrypted with the access key ID value and secret key
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    Content-TypeYESSpecifies the request body content type as application/json
    Content-Type: application/json
    x-ncp-region_codeYESRegion code (KR)

    Request body

    Field nameRequirement statusTypeRestrictionsDescription
    channelNameYesStringThis must be between 3 and 20 characters in length
    Underscores (_) allowed
    Name of the channel to be created
    outputProtocolOptionalStringHLS
    HLS,DASH
    LL_HLS
    Output protocol settings
    Will be set to HLS if not entered
    envTypeOptionalStringDEV, STAGE, REALUsage classification settings for the created channel
    Will be set to REAL if not entered
    cdnYesObjectCDN Object
    cdn.createCdnYesBooleantrue, falseCDN Object
    cdn.cdnTypeYesStringCDN_PLUS, GLOBAL_CDN,GLOBAL_EDGE
    cdn.profileIdYesIntegerA Global Edge profile required when creating a new GLOBAL_EDGE
    cdn.regionTypeYesStringKOREA,JAPAN,GLOBALGlobal Edge service region
    cdn.cdnInstanceNoOptionalIntegerThis must be set if cdn.createCdn is false
    qualitySetIdYesInteger
    drmEnabledYnYesBooleanWhether to apply DRM Encryption settings
    drmOptionalObjectDRM Encryption settings using Live Station
    When setting DRM, FairPlay and Widevine/PlayReady DRM are supported
    drm.siteIdOptionalStringSite id created through One Click Multi DRM product
    drm.contentIdOptionalStringUnique 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 nameTypeDescriptionRemarks
    channelIdString
    channelNameString
    outputProtocolOptionalStringHLS
    HLS, DASH
    LL_HLS
    envTypeStringDEV, STAGE, REAL
    cdnObject
    cdn.createCdnBoolean
    cdn.cdnTypeYesStringCDN_PLUS, GLOBAL_CDN,GLOBAL_EDGE
    cdn.profileIdYesInteger
    cdn.regionTypeYesStringKOREA,JAPAN,GLOBAL
    cdn.cdnInstanceNoOptionalInteger
    qualitySetIdInteger
    typeString
    drmEnabledYnBooleanWhether to apply DRM Encryption settings
    drmObjectDRM Encryption settings using Live Station
    When setting DRM, FairPlay and Widevine/PlayReady DRM are supported
    drm.siteIdStringSite id created through One Click Multi DRM product
    drm.contentIdStringUnique 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?

    What's Next
    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.