Get service URL
- Print
- PDF
Get service URL
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
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}
Request parameters
| Parameter name | Required | Type | Restrictions | Description |
|---|---|---|---|---|
| serviceUrlType | Yes | String | GENERAL, THUMBNAIL | GENERAL : HLS and MPEG-DASH live playback URL 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 minutesx-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | YES | Access key ID value issued on 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 | Specify the request body content type as application/jsonContent-Type: application/json |
| x-ncp-region_code | YES | Region code (KR) |
Response
| Field name | Type | Description | Remarks |
|---|---|---|---|
| name | String | ||
| url | String | ||
| resizedUrl | Array | ||
| resizedUrl.type | String | ||
| resizedUrl.url | String | ||
| resolution | String | ||
| videoBitrate | String | ||
| audioBitrate | String |
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
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/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
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?