Get service URL

Article summary

Did you find this summary helpful?

Thank you for your feedback

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}

Request parameters

Parameter name	Required	Type	Restrictions	Description
serviceUrlType	Yes	String	GENERAL, TIMEMACHINE, THUMBNAIL	GENERAL : 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 name	Required	Description
x-ncp-apigw-timestamp	YES	It 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-key	YES	Access key ID value issued on NAVER Cloud Platform portal `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	YES	Signature encrypted with the access key ID value and secret key `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	YES	Specify the request body content type as application/json `Content-Type: application/json`
x-ncp-region_code	YES	Region code (KR)

Response

Field name	Type	Description	Remarks
name	String
url	String
resizedUrl	List
resizedUrl.type	String
resizedUrl.url	String
resolution	String
videoBitrate	String
audioBitrate	String

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

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"
      }
   ]
}

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

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"
        }
      ]
    }
  ]
}

Was this article helpful?

What's Next

Create snapshot

Table of contents

Request
Response
Examples