View service URL
- Print
- PDF
View service URL
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
An API to view the live playback URL and thumbnail URL of VOD channels created in Live Station.
Requests
Caution
You can only obtain the live playback URL and thumbnail URL of a VOD channel when the channel status is RESERVED or PUBLISHING.
GET https://livestation.apigw.ntruss.com/api/v2/vod/channels/{channelId}/serviceUrls?serviceUrlType={serviceUrlType}
Request parameters
| Parameter name | Required | Type | Service limits | Description |
|---|---|---|---|---|
| serviceUrlType | Yes | String | GENERAL, THUMBNAIL | GENERAL: HLS and MPEG-DASH live playback URLs THUMBNAIL: thumbnail URL |
Request headers
| Header name | Required | Description |
|---|---|---|
| x-ncp-apigw-timestamp | YES | Time elapsed since January 1, 1970 00:00:00 UTC in milliseconds. The request is considered invalid if the time difference compared to the API Gateway server is 5 minutes or longerx-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | YES | Access key ID value issued from NAVER Cloud Platform portalx-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 | YES | Signature encrypted with the access key ID value and secret keyx-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | YES | Specifies the request body content type as application/jsonContent-Type: application/json |
| x-ncp-region_code | YES | Region code (KR) |
Responses
| Field name | Type | Description | Note |
|---|---|---|---|
| name | String | ||
| url | String | ||
| resizedUrl | Array | ||
| resizedUrl.type | String | ||
| resizedUrl.url | String | ||
| resolution | String | ||
| videoBitrate | String | ||
| audioBitrate | String |
Examples
Request examples of GENERAL types
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
Response examples of GENERAL types
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"
}
]
}
Request examples of THUMBNAIL types
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
Response examples of THUMBNAIL types
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"
}
]
}
]
}
Was this article helpful?