Get Service URL

This API checks live playback URL, time machine URL, and thumbnail URL of the channel generated by Live Station.

Request

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

Request parameter

Request header

Response

Examples

General Request example

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

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

Error codes

If the Live Station API request is invalid or if an error occurs during processing, it returns a success/failure to HTTP status code and returns a detailed message in JSON format.

There are two error codes: 'Common error codes' and 'API Gateway error codes' in the Live Station API.