Get Service URL
- Print
- PDF
Get Service URL
- Print
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
The API that searches for the live streaming URL of a VOD channel created at Live Station, or the thumbnail URL.
Request
Notes
The URLs for the VOD channel's live streaming and thumbnails 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 parameter
| Parameter name | Requirement status | Type | Restrictions | Description |
|---|---|---|---|---|
| serviceUrlType | Yes | String | GENERAL, THUMBNAIL | GENERAL: HLS and MPEG-DASH live streaming URL THUMBNAIL: Thumbnail URL |
Request header
| Header name | Requirement status | Description |
|---|---|---|
| x-ncp-apigw-timestamp | YES | It indicates the time elapsed since January 1, 1970 00:00:00 UTC in milliseconds, and if the time difference compared to the API Gateway server is more than 5 minutes, then the request is considered invalidx-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | YES | Access key ID value issued on the 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) |
Response
| Field name | Type | Description | Remarks |
|---|---|---|---|
| name | String | ||
| url | String | ||
| resizedUrl[] | Array | ||
| resizedUrl[].type | String | ||
| resizedUrl[].url | String | ||
| resolution | String | ||
| videoBitrate | String | ||
| audioBitrate | String |
Example
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.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 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.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?