인코딩 옵션 목록 조회

Prev Next

VOD Station은 인코딩 옵션의 상세 정보를 조회하기 위한 API를 제공합니다.

요청

GET https://vod-station.apigw.gov-ntruss.com/api/v2/encoding-option

요청 헤더

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

응답

필드명 타입 설명 비고
error Object 요청 실패 시 응답
오류 응답 코드 및 메시지
error.code Integer 오류 응답 코드
error.message String 오류 응답 메시지
content[] Array(Object) VOD Station OPEN API 응답 객체
content[].disabled Boolean subaccount 제공 필드
해당 리소스가 subaccount에서 활성 여부
content[].id String 인코딩 옵션 ID
content[].name String 인코딩 옵션의 이름
content[].format String 변환된 미디어 파일 컨테이너 포맷
content[].encodingOptionType String 인코딩 옵션의 타입
content[].audio Object 트랜스코딩 오디오 옵션 설정 객체
content[].audio.codec String 오디오 코덱 설정
content[].audio.channel Integer 출력 오디오의 채널 설정
content[].audio.bitrate Integer 트랜스코딩할 오디오 스트림의 비트 전송률 설정 (단위 : Kbps)
content[].audio.samplingRate Integer 출력 오디오 샘플링 레이트 (단위 : Hz)
content[].video Object 트랜스코딩 비디오 옵션 설정 객체
content[].video.codec String 비디오 코덱 설정
content[].video.codecOptions Object 비디오 코덱 상세옵션 설정 객체
content[].video.codecOptions.profile String 설정된 Video Codec Profile
content[].video.codecOptions.level String 설정된 Video Codec Level
content[].video.bitrate Integer 비디오 스트림의 비트 전송률 (단위 : Kbps)
content[].video.width Integer 출력 비디오의 너비
content[].video.height Integer 출력 비디오의 높이
content[].video.framerate Double 초당 프레임 수
content[].video.keyframeInterval Integer 비디오에 키 프레임이 생성되는 간격 (단위 : 초)
content[].video.rateControl String 비트레이트 배분 방식
content[].defaultSet Boolean 시스템 제공 프리셋 여부
total Integer 인코딩 옵션 총 개수

예시

요청 예시

GET https://vod-station.apigw.gov-ntruss.com/api/v2/encoding-option

GET /api/v2/encoding-option
HOST: vod-station.apigw.gov-ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

응답 예시

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": [
      {
        "disabled": false,
        "id": 10058,
        "encodingOptionType": "NORMAL",
        "name": "basic-enc-option",
        "format": "MP4",
        "video": {
          "codec": "AVC",
          "codecOptions": {
            "profile": "MAIN",
            "level": "3.1"
          },
          "bitrate": 5000,
          "width": 1920,
          "height": 1080,
          "framerate": 30,
          "maxFramerate": 30,
          "keyframeInterval": 2,
          "rateControl": "ABR",
          "pass": "1-Pass"
        },
        "audio": {
          "codec": "AAC",
          "bitrate": 192,
          "channel": 2,
          "samplingRate": 44100
        }
      }
  ],
  "total": 1
}