MENU
      Get service URL

        Get service URL


        Article summary

        This is an API for getting live playback URL and thumbnail URL of a VOD channel created in Live Station.

        Request

        Caution

        The URLs for the VOD channel's live playback and thumbnail can only be obtained when the channel status is RESERVED or PUBLISHING.

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

        Request parameters

        Parameter nameRequiredTypeRestrictionsDescription
        serviceUrlTypeYesStringGENERAL, THUMBNAILGENERAL : HLS and MPEG-DASH live playback URL
        THUMBNAIL : thumbnail URL

        Request headers

        Header nameRequiredDescription
        x-ncp-apigw-timestampYESIt indicates the elapsed time in milliseconds since January 1, 1970 00:00:00 UTC. Request is considered invalid if the timestamp differs from the current time by more than 5 minutes
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYESAccess key ID value issued on 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-TypeYESSpecify the request body content type as application/json
        Content-Type: application/json
        x-ncp-region_codeYESRegion code (KR)

        Response

        Field nameTypeDescriptionRemarks
        nameString
        urlString
        resizedUrlArray
        resizedUrl.typeString
        resizedUrl.urlString
        resolutionString
        videoBitrateString
        audioBitrateString

        Examples

        GENERAL type request example

        GET /api/v2/vod/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 type response example

        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 type request example

        GET /api/v2/vod/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 type response example

        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

        Was this article helpful?

        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.