채널 생성

VOD Station은 채널을 생성하기 위한 API를 제공하며, 생성한 채널 조회를 위해 채널 목록 조회 API와 채널 정보 조회 API를 제공합니다.

요청

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

요청 헤더

요청 바디

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)
{
   "cdn": {
     "profileId": 681,
     "regionType": "KOREA",
     "type": "GLOBAL_EDGE"
   },
   "createCdn": true,
  "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"
    }
  }
}