MENU
      채널 정보 조회

        채널 정보 조회


        기사 요약

        Live Station은 VOD 채널의 상세 정보를 조회하기 위한 API를 제공합니다.

        요청

        GET https://livestation.apigw.ntruss.com/api/v2/vod/channels/{channelId}
        HTTP

        요청 헤더

        헤더명필수 여부설명
        x-ncp-apigw-timestampYES1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYES네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESAccess Key ID 값과 Secret Key로 암호화한 서명
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        x-ncp-region_codeYES리전 코드 (KR)

        응답

        필드명타입설명비고
        channelNameString
        channelIdString
        instanceNoString
        channelStatusStringCREATING, READY, PUBLISHING, DELETED, BLOCK,RESERVED, FORCE_BLOCK, FORCE_DELETED
        createdTimeString
        cdnObject
        cdn.cdnTypeStringGLOBAL_CDN, GLOBAL_EDGE
        cdn.instanceNoStringNO_CDN 이면 0
        cdn.profileIdIntegerGlobal Edge 의 프로필 IDNO_CDN 이면 0
        cdn.statusNameStringCDN 상태RUNNING, PUBLISHING, STOPPING, STOPPED, CREATING, CHANGING, CDN_NOT_FOUND
        cdn.serviceNameStringCDN Service NameNO_CDN 이면 ""
        cdn.cdnDomainStringCDN DomainNO_CDN 이면 ""
        qualitySetIdInteger
        qualitySetNameString
        outputProtocolString
        alertOnBoolean
        alertOptionsObject
        alertOptions.alertChangeStatusBoolean
        totalPublishSecondsInteger
        createdTimeInteger
        updatedTimeInteger
        envTypeStringDEV, STAGE, REAL
        typeStringVOD
        callbackEndpointString
        scheduleListArray스케줄이 존재할때만 응답
        scheduleList.scheduleIdInteger
        scheduleList.statusString
        drmEnabledYnBooleanDRM Encryption 설정 적용 유무
        drmObjectLive Station 을 활용한 DRM Encryption 설정
        DRM 설정시 FairPlay, Widevine/PlayReady DRM 지원
        drm.siteIdStringOne Click Multi DRM 상품을 통해 생성한 site id
        drm.contentIdStringDRM Encryption 을 적용할 콘텐츠의 고유 ID
        DRM 패키징을 위해 사용되며 최소 3글자 이상 영문/숫자 또는 ‘-'(하이픈), ‘_'(언더바) 포함 최대 100자 문자까지 입력 가능합니다.

        예시

        요청 예시

        GET /api/v2/vod/channels/ls-20211122220557-mUv3r
        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
        HTTP

        응답 예시

        {
          "content": {
            "channelId": "ls-20211122220557-mUv3r",
            "channelName": "myChannel",
            "instanceNo": 2043025,
            "qualitySetId": 4,
            "qualitySetName": "720p-set",
            "outputProtocol": "HLS",
            "status": "READY",
            "cdn": {
              "instanceNo": "1541959",
              "serviceName": "edge-ls-20201204112949-D7RTL",
              "statusName": "RUNNING",
              "cdnType": "GLOBAL_EDGE",
              "cdnDomain": "mycdn.edge.naverncp.com",
              "profileId": 299,
              "regionType": "KOREA"
            },
            "totalPublishSeconds": 0,
            "createdTime": 1637586357000,
            "updatedTime": 1637679496000,
            "alertOn": false,
            "alertOptions": {
              "alertChangeStatus": false
            },
            "callbackEndpoint": "http://ey.1123.callback",
            "envType": "REAL",
            "type": "VOD",
            "drmEnabledYn": true,
            "drm": {
              "siteId": "drm-20231115142326-nHyNw",
              "contentId": "my-Test-Multidrm"
            }
          }
        }
        Plain text

        이 문서가 도움이 되었습니까?

        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.