Live Station 개요

Prev Next

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

Live Station은 라이브 방송 서비스 구축에 필요한 모든 기능을 제공하는 네이버 클라우드 플랫폼의 영상 인코딩 플랫폼 서비스입니다. Live Station 서비스에서는 라이브 채널 관리, 숏클립/라이브 커튼 생성 및 관리, 화질 관리, 동시 송출(Re-Stream) 채널 관리, VOD2LIVE 채널 관리, 이벤트 관리 기능을 RESTful API 형태로 제공합니다.

Live Station 공통 설정

Live Station API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://livestation.apigw.ntruss.com

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
  • Unix Timestamp 형식
x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
Content-Type Required 요청 데이터의 형식
  • application/json
x-ncp-region_code Required 리전 코드
  • KR (유효 값)

응답

공통 응답 형식을 설명합니다.

응답 바디

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

error

error는 API 호출 실패 정보를 정의합니다. error에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
error Object - 오류 코드 및 메시지
error.errorCode String Required 오류 코드
error.message String Required 오류 메시지
error.errorName String Required 오류 이름

응답 상태 코드

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

참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

응답 예시

호출이 성공한 경우의 응답 예시는 각 API 명세에서 확인해 주십시오. 호출이 실패한 경우의 응답 예시는 다음과 같습니다.

{
    "error": {
        "errorCode": 250000,
        "message": "Unexpected error occurred.",
        "errorName": "EXCEPTION"
    }
}

Live Station API

Live Station 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

Channel Management

Channel Management 관련 API에 대한 설명은 다음과 같습니다.

Channel

Channel 관련 API에 대한 설명은 다음과 같습니다.

API 설명
채널 생성 라이브 채널 생성
채널 목록 조회 라이브 채널 목록 조회
채널 스트림 메타데이터 조회 라이브 채널의 송출 스트림 메타데이터 조회
채널 조회 라이브 채널 상세 정보 조회
채널 Service URL 조회 채널 라이브 재생 URL, 타임머신 URL, 섬네일 URL 조회
채널 설정 변경 라이브 채널 설정 변경
채널 정지 라이브 채널 정지
채널 정지 해제 정지된 라이브 채널 활성화
채널 CDN 변경 라이브 채널의 연동 CDN 서버 변경
채널 CDN 일괄 변경 2개 이상 라이브 채널의 연동 CDN 서버 일괄 변경
채널 반납 라이브 채널 반납

Recording

Recording 관련 API에 대한 설명은 다음과 같습니다.

API 설명
녹화 시작 채널 송출 중 녹화 시작
녹화 종료 채널 녹화 종료
녹화 파일 업로드 녹화 파일을 Object Storage 버킷에 업로드
녹화 파일 목록 조회 녹화 파일 목록 조회
녹화 파일 조회 녹화 파일 상세 정보 조회
녹화 파일 삭제 녹화 파일 삭제

Short Clip

Short Clip 관련 API에 대한 설명은 다음과 같습니다.

API 설명
스냅샷 생성 송출 중인 라이브 채널의 스냅샷 생성
스냅샷 조회 스냅샷 상세 정보 조회
숏클립 생성 스냅샷을 기반으로 라이브 숏클립 생성
숏클립 목록 조회 라이브 숏클립 목록 조회
숏클립 조회 라이브 숏클립 상세 정보 조회

Live Curtain

Live Curtain 관련 API에 대한 설명은 다음과 같습니다.

API 설명
라이브 커튼 콘텐츠 생성 라이브 커튼에 사용할 콘텐츠 생성
라이브 커튼 콘텐츠 목록 조회 라이브 커튼 콘텐츠 목록 조회
라이브 커튼 콘텐츠 조회 라이브 커튼 콘텐츠의 상세 정보 조회
라이브 커튼 콘텐츠 삭제 라이브 커튼 콘텐츠 삭제
라이브 커튼 시작 라이브 커튼 송출 시작
라이브 커튼 종료 라이브 커튼 송출 강제 종료

Quality Management

Quality Management 관련 API에 대한 설명은 다음과 같습니다.

Quality Profile

Quality Profile 관련 API에 대한 설명은 다음과 같습니다.

API 설명
화질 목록 조회 전체 화질 목록 조회
화질 조회 전체 화질 상세 정보 조회
Custom 화질 생성 Custom 화질 생성
Custom 화질 삭제 Custom 화질 삭제

Quality Setting

Quality Setting 관련 API에 대한 설명은 다음과 같습니다.

API 설명
화질 설정 목록 조회 전체 화질 설정 목록 조회
화질 설정 조회 전체 화질 설정 상세 정보 조회
Custom 화질 설정 생성 Custom 화질 설정 생성
Custom 화질 설정 수정 Custom 화질 설정 수정
Custom 화질 설정 삭제 Custom 화질 설정 삭제

Re-Stream Management

Re-Stream Management 관련 API에 대한 설명은 다음과 같습니다.

API 설명
채널 생성 동시 송출 채널 생성
동시 송출 플랫폼 목록 조회 동시 송출 플랫폼 목록 조회
채널 목록 조회 동시 송출 채널 목록 조회
채널 조회 동시 송출 채널의 상세 정보 조회
동시 송출 플랫폼 수정 동시 송출 플랫폼 정보 수정
채널 반납 동시 송출 채널 반납

VOD2LIVE Management

VOD2LIVE Management 관련 API에 대한 설명은 다음과 같습니다.

Channel

Channel 관련 API에 대한 설명은 다음과 같습니다.

API 설명
채널 생성 VOD2LIVE 채널 생성
채널 목록 조회 VOD2LIVE 채널 목록 조회
채널 조회 VOD2LIVE 채널 상세 정보 조회
채널 Service URL 조회 VOD2LIVE 채널 재생 URL, 섬네일 URL 조회
채널 설정 변경 VOD2LIVE 채널 설정 변경
채널 정지 VOD2LIVE 채널 정지
채널 정지 해제 정지된 VOD2LIVE 채널 활성화
채널 CDN 변경 VOD2LIVE 채널에 연결된 CDN 서버 변경
채널 CDN 일괄 변경 여러 VOD2LIVE 채널의 CDN 서버 일괄 변경
채널 반납 VOD2LIVE 채널 반납

Schedule

Schedule 관련 API에 대한 설명은 다음과 같습니다.

API 설명
스케줄 생성 VOD 송출 스케줄 생성
스케줄 조회 VOD 송출 스케줄 조회
스케줄 수정 VOD 송출 스케줄 수정
스케줄 삭제 VOD 송출 스케줄 삭제

Event

Event 관련 API에 대한 설명은 다음과 같습니다.

API 설명
관리자 그룹 목록 조회 관리자 그룹 목록 조회
관리자 조회 관리자 정보 조회
이벤트 알람 설정 이벤트 알람 설정
이벤트 목록 조회 모든 채널의 이벤트 목록 조회
Live 채널 송출 이벤트 목록 조회 라이브 채널의 송출 이벤트 목록 조회
Live 채널 이벤트 목록 조회 라이브 채널의 이벤트 목록 조회
Re-Stream 채널 송출 이벤트 목록 조회 동시 송출 채널의 송출 이벤트 목록 조회
Re-Stream 채널 이벤트 목록 조회 동시 송출 채널의 이벤트 목록 조회
Callback Endpoint 등록 모든 채널 이벤트 알람을 수신할 기본 콜백 엔드포인트 등록
Callback Endpoint 등록(Live) 라이브 채널 이벤트 알람을 수신할 콜백 엔드포인트 등록
Callback Endpoint 등록(Re-Stream) 동시 송출 채널 이벤트 알람을 수신할 콜백 엔드포인트 등록
Callback Endpoint 등록(VOD2LIVE) VOD2LIVE 채널 이벤트 알람을 수신할 콜백 엔드포인트 등록
Callback Endpoint 조회 등록된 콜백 엔드포인트 조회

Live Station 연관 리소스

Live Station API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.