채널 생성

Prev Next

Live Station 의 VOD 채널을 생성하는 API 입니다. 생성한 채널 조회를 위해 채널 목록 조회 API채널 정보 조회 API를 제공합니다.

콘텐츠 보호 설정

Live Station DRM Encryption 은 실시간 콘텐츠의 Multi DRM 을 지원합니다.
채널 생성 내 DRM 설정 영역에서 간편하게 DRM 기능을 설정할 수 있으며 선택한 OutputProtocol 에 따라 Multi DRM Encryption 을 지원합니다.
DRM 기술별 암호화 방식 및 지원 단말과 다른 플랫폼 및 버전에 대한 상세 정보는 링크를 참고해 주십시오.

암호화 방식 프로토콜 DRM 유형 암호화 알고리즘 지원 단말
DRM HLS FairPlay AES-CBC Mac/iOS Safari 브라우저, iOS/iPadOS/tvOS 앱, HLS HTML5
DRM DASH PlayReady, Widevine CENC (Common Encryption) MS Edge, Internet Explorer 11, Google Chrome, Firefox, Opera DASH HTML5
  • 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 네이버 클라우드 플랫폼 포털에서 발급받은 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"
    }
  }
}