Service URL 조회

인쇄
공유
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

Live Station 에서 생성된 채널의 라이브 재생 URL, 타임머신 URL, 썸네일 URL 을 조회하는 API 입니다.

요청

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

요청 파라미터

파라미터명	필수 여부	타입	제약 사항	설명
serviceUrlType	Yes	String	GENERAL, TIMEMACHINE, THUMBNAIL	GENERAL : HLS 와 MPEG-DASH 라이브 재생 URL TIMEMACHINE : 되돌려보기가 가능한 HLS URL (DVR(타임머신) 설정을 사용하는 채널에서 ON_AIR 상태일 때만 획득 가능) THUMBNAIL : 썸네일 URL

요청 헤더

헤더명	필수 여부	설명
x-ncp-apigw-timestamp	YES	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	YES	네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값 `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	YES	Access Key ID 값과 Secret Key로 암호화한 서명 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	YES	Request body content type을 application/json으로 지정 `Content-Type: application/json`
x-ncp-region_code	YES	리전 코드 (KR)

응답

필드명	타입	설명	비고
name	String
url	String
resizedUrl	List
resizedUrl.type	String
resizedUrl.url	String
resolution	String
videoBitrate	String
audioBitrate	String

예시

GENERAL 타입 요청 예시

GET /api/v2/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 타입 응답 예시

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 타입 요청 예시

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 타입 응답 예시

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"
        }
      ]
    }
  ]
}

이 문서가 도움이 되었습니까?

What's Next

스냅샷 생성

요청
응답
예시

태그