MENU
      Get service URL

        Get service URL


        Article summary

        It is an API that gets the live streaming URL, time machine URL, and thumbnail URL of a channel created in Live Station.

        Request

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

        Request parameters

        Parameter nameRequiredTypeRestrictionsDescription
        serviceUrlTypeYesStringGENERAL, TIMEMACHINE, THUMBNAILGENERAL : HLS and MPEG-DASH live playback URL
        TIMEMACHINE : rewindable HLS URL (only obtainable when ON_AIR on channels that use the DVR (Time Machine) setting)
        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
        resizedUrlList
        resizedUrl.typeString
        resizedUrl.urlString
        resolutionString
        videoBitrateString
        audioBitrateString

        Examples

        GENERAL type request example

        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 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/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.