VOD Station 개요

Prev Next

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

VOD Station은 저장된 영상을 다양한 디바이스에서 시청할 수 있도록 변환하는 인코딩 기능과 동영상 파일을 패킷타이징하여 네트워크를 효율적으로 사용할 수 있는 스트리밍 기능을 제공하는 네이버 클라우드 플랫폼의 VOD 전용 서비스입니다. VOD Station 서비스에서는 영상의 인코딩 및 스트리밍 기능을 RESTful API 형태로 제공합니다.

VOD Station 공통 설정

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

요청

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

API URL

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

https://vodstation.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 Optional 요청 데이터의 형식
  • application/json
x-ncp-region_code Optional 리전 코드
  • KR: 한국 (유효 값)

응답

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

응답 바디

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

error

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

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

응답 상태 코드

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

응답 예시

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

{
    "error": {
        "errorCode": "300",
        "message": "Not Found Exception"
    }
}

VOD Station API

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

Channel

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

API 설명
채널 생성 VOD 스트리밍 채널 생성
채널 목록 조회 VOD 스트리밍 채널 목록 조회
채널 이벤트 조회 VOD 스트리밍 채널에서 발생한 이벤트 조회
채널 조회 VOD 스트리밍 채널 상세 정보 조회
프로토콜 목록 조회 지원하는 스트리밍 프로토콜 조회
채널 시작 VOD 스트리밍채널 시작
채널 정지 VOD 스트리밍 채널 정지
채널 CDN 변경 VOD 스트리밍 채널 CDN 변경
채널 삭제 VOD 스트리밍 채널 삭제

Category

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

API 설명
카테고리 생성 영상 파일 인코딩을 위한 카테고리 생성
카테고리 목록 조회 2개 이상의 카테고리 목록 조회
카테고리 조회 카테고리 상세 정보 조회
카테고리 수정 카테고리 상세 정보 수정
카테고리 파일 추가 카테고리 내 인코딩 파일 추가
카테고리 삭제 생성한 카테고리 삭제
카테고리 콜백 사용 인코딩 요청 상태 확인을 위한 콜백 사용 설정

Encoding Option

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

API 설명
인코딩 옵션 생성 영상 파일 변환을 위한 인코딩 옵션 생성
인코딩 옵션 목록 조회 2개 이상의 인코딩 옵션 목록 조회
인코딩 옵션 조회 인코딩 옵션 상세 정보 조회
인코딩 옵션 템플릿 목록 조회 2개 이상의 인코딩 템플릿 목록 조회
인코딩 옵션 삭제 생성한 인코딩 옵션 삭제

Status

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

API 설명
카테고리 상태 목록 조회 카테고리별 인코딩 상태 목록 조회
카테고리 상태 조회 카테고리 인코딩 상태 상세 정보 조회
카테고리 통계 조회 카테고리 파일 인코딩 통계 조회

VOD Station 연관 리소스

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