MENU
      Service URL 조회

        Service URL 조회


        기사 요약

        Live Station 에서 생성된 채널의 라이브 재생 URL, 타임머신 URL, 썸네일 URL 을 조회하는 API 입니다.

        요청

        GET https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/serviceUrls?serviceUrlType={serviceUrlType}
        HTTP

        요청 파라미터

        파라미터명필수 여부타입제약 사항설명
        serviceUrlTypeYesStringGENERAL, TIMEMACHINE, THUMBNAILGENERAL : HLS 와 MPEG-DASH 라이브 재생 URL
        TIMEMACHINE : 되돌려보기가 가능한 HLS URL (DVR(타임머신) 설정을 사용하는 채널에서 ON_AIR 상태일 때만 획득 가능)
        THUMBNAIL : 썸네일 URL

        요청 헤더

        헤더명필수 여부설명
        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}
        Content-TypeYESRequest body content type을 application/json으로 지정
        Content-Type: application/json
        x-ncp-region_codeYES리전 코드 (KR)

        응답

        필드명타입설명비고
        nameString
        urlString
        resizedUrlList
        resizedUrl.typeString
        resizedUrl.urlString
        resolutionString
        videoBitrateString
        audioBitrateString

        예시

        GENERAL 타입 요청 예시

        GET /api/v2/channels/ls-20200326194008-jk9ld/serviceUrls?serviceUrlType=GENERAL
        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

        GENERAL 타입 응답 예시

        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" : [
              {
                 "name":"720p-16-9",
                 "url":"https://test123.edge.naverncp.com/live/video/ls-20200326194008-jk9ld/720p-16-9/playlist.m3u8",
                 "resolution":"1280x720",
                 "videoBitrate":"2500000",
                 "audioBitrate":"128000"
              },
              {
                 "name":"480p-16-9",
                 "url":"https://test123.edge.naverncp.com/live/video/ls-20200326194008-jk9ld/480p-16-9/playlist.m3u8",
                 "resolution":"854x480",
                 "videoBitrate":"1200000",
                 "audioBitrate":"128000"
              },
              {
                 "name":"360p-16-9",
                 "url":"https://test123.edge.naverncp.com/live/video/ls-20200326194008-jk9ld/360p-16-9/playlist.m3u8",
                 "resolution":"640x360",
                 "videoBitrate":"800000",
                 "audioBitrate":"96000"
              },
              {
                 "name":"audio-192k",
                 "url":"https://test123.edge.naverncp.com/live/video/ls-20200326194008-jk9ld/audio-192k/playlist.m3u8",
                 "audioBitrate":"192000"
              },
              {
                "name":"ABR",
                 "url":"https://test123.edge.naverncp.com/live/video/ls-20200326194008-jk9ld/playlist.m3u8"
              },
              {
                 "name":"dash",
                 "url":"https://test123.edge.naverncp.com/live/video/ls-20200326194008-jk9ld/live.mpd"
              }
           ]
        }
        HTTP

        THUMBNAIL 타입 요청 예시

        GET /api/v2/channels/ls-20210625135517-XeRA2/serviceUrls?serviceUrlType=THUMBNAIL
        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

        THUMBNAIL 타입 응답 예시

        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": [
            {
              "name": "thumbnail",
              "url": "https://test123.edge.naverncp.com/live/image/ls-20210625135517-XeRA2/thumbnail.jpg",
              "resizedUrl": [
                {
                  "type": "100px",
                  "url": "https://test123.edge.naverncp.com/live/image/ls-20210625135517-XeRA2/100px/thumbnail.jpg"
                },
                {
                  "type": "360px",
                  "url": "https://test123.edge.naverncp.com/live/image/ls-20210625135517-XeRA2/360px/thumbnail.jpg"
                },
                {
                  "type": "720px",
                  "url": "https://test123.edge.naverncp.com/live/image/ls-20210625135517-XeRA2/720px/thumbnail.jpg"
                }
              ]
            }
          ]
        }
        HTTP

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

        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.