채널 Service URL 조회

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

라이브 채널의 라이브 재생 URL, 타임머신 URL, 섬네일 URL을 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET /api/v2/channels/{channelId}/serviceUrls

요청 헤더

Live Station API에서 공통으로 사용하는 헤더에 대한 정보는 Live Station 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
channelId String Required 채널 아이디

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
serviceUrlType String Required Servcie URL 유형
  • GENERAL | TIMEMACHINE | THUMBNAIL
    • GENERAL: 라이브 재생 URL(HLS 및 MPEG-DASH)
    • TIMEMACHINE: 타임머신 URL. 타임머신(DVR)을 설정한 채널이 송출 중일 때만 조회 가능
    • THUMBNAIL: 섬네일 이미지 URL

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/serviceUrls?serviceUrlType=GENERAL' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

GENERAL

라이브 재생 URL 요청 시 응답 바디는 다음과 같습니다.

필드 타입 필수 여부 설명
content Array - 라이브 재생 URL 정보
content.name String - 화질 이름
content.url String - 라이브 재생 URL
content.resolution String - 비디오 해상도
content.videoBitrate String - 비디오 스트림의 비트레이트(bps)
content.audioBitrate String - 오디오 스트림의 비트레이트(bps)

TIMEMACHINE

타임머신 URL 요청 시 응답 바디는 다음과 같습니다.

필드 타입 필수 여부 설명
content Array - 타임머신 URL 정보
content.name String - 화질 이름
content.url String - 타임머신 재생 URL
content.resolution String - 비디오 해상도
content.videoBitrate String - 비디오 스트림의 비트레이트(bps)
content.audioBitrate String - 오디오 스트림의 비트레이트(bps)

THUMBNAIL

섬네일 이미지 URL 요청 시 응답 바디는 다음과 같습니다.

필드 타입 필수 여부 설명
content Array - 섬네일 이미지 URL 정보
content.name String - 섬네일 이름
content.url String - 섬네일 이미지 URL
content.resizedUrl Array - 리사이즈된 섬네일 이미지 URL 목록
content.resizedUrl.type String - 섬네일 이미지 크기
content.resizedUrl.url String - 섬네일 이미지 URL

응답 상태 코드

Live Station API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Live Station 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

GENERAL URL을 조회하는 경우

라이브 재생 URL을 조회하는 경우, 응답 예시는 다음과 같습니다.

{
    "content": [
        {
            "name": "480p-16-9",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/480p-16-9/playlist.m3u8",
            "resolution": "854x480",
            "videoBitrate": "1200000",
            "audioBitrate": "128000"
        },
        {
            "name": "360p-16-9",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/360p-16-9/playlist.m3u8",
            "resolution": "640x360",
            "videoBitrate": "800000",
            "audioBitrate": "96000"
        },
        {
            "name": "audio-192k",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/audio-192k/playlist.m3u8",
            "audioBitrate": "192000"
        },
        {
            "name": "ABR",
            "url": "https://*************.edge.naverncp.com/live/video/ls-20250814******-zTwK2/playlist.m3u8"
        }
    ]
}

TIMEMACHINE URL을 조회하는 경우

타임머신 URL을 조회하는 경우, 응답 예시는 다음과 같습니다.

{
    "content": [
        {
            "name": "480p-16-9",
            "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/480p-16-9/playlist.m3u8",
            "resolution": "854x480",
            "videoBitrate": "1200000",
            "audioBitrate": "128000"
        },
        {
            "name": "360p-16-9",
            "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/360p-16-9/playlist.m3u8",
            "resolution": "640x360",
            "videoBitrate": "800000",
            "audioBitrate": "96000"
        },
        {
            "name": "audio-192k",
            "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/audio-192k/playlist.m3u8",
            "audioBitrate": "192000"
        },
        {
            "name": "ABR",
            "url": "https://*************.edge.naverncp.com/dvr/video/ls-20250814******-zTwK2/playlist.m3u8"
        }
    ]
}

THUMBNAIL URL을 조회하는 경우

섬네일 URL을 조회하는 경우, 응답 예시는 다음과 같습니다.

{
    "content": [
        {
            "name": "thumbnail",
            "url": "https://*************.edge.naverncp.com/live/image/ls-20250814******-zTwK2/thumbnail.jpg",
            "resizedUrl": [
                {
                    "type": "100px",
                    "url": "https://*************.edge.naverncp.com/live/image/ls-20250814******-zTwK2/100px/thumbnail.jpg"
                },
                {
                    "type": "360px",
                    "url": "https://*************.edge.naverncp.com/live/image/ls-20250814******-zTwK2/360px/thumbnail.jpg"
                },
                {
                    "type": "720px",
                    "url": "https://*************.edge.naverncp.com/live/image/ls-20250814******-zTwK2/720px/thumbnail.jpg"
                }
            ]
        }
    ]
}