Service URL 조회
    • PDF

    Service URL 조회

    • PDF

    기사 요약

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

    요청

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

    요청 파라미터

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

    요청 헤더

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

    응답

    필드명타입설명비고
    nameString
    urlString
    resizedUrlList
    resizedUrl.typeString
    resizedUrl.urlString
    resolutionString
    videoBitrateString
    audioBitrateString

    예시

    GENERAL 요청 예시

    GET /api/fin-v2/channels/{channelId}/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:FKR
    

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

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

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.