VOD Transcoder API v1 Reference

이 Reference 가이드는 File Storage를 연동할 수 있는 v1 API를 기반으로 작성되었습니다.

VOD Transocder API v1은 안정적인 처리를 위해 초당 12회로 요청 수를 제한하고 있습니다.

Object Storage용 v2 API는 "VOD Transcoder(v2, 신버전) API 참조서"를 참고하세요.

2019년 5월부터 VOD Transcoder의 File Stroage 연동 및 VOD Transcoder v1 API의 지원이 중단됩니다.

목차

VOD Transcoder API v1 Content-Type

HTTP Request와 Response body를 통해 전달되는 모든 데이터의 content-type은 application/json을 사용합니다.

Job Operation API

Job 생성

Job을 생성하는 API

POST https://vodtranscoder.apigw.ntruss.com/api/v1/jobs

Request header

VOD Transcoder open api 요청시 필드명(key)은 대소문자 구분이 필요하며 입력값(value)은 대소문자를 구분하지 않습니다

필드명 필수 여부 타입 제약 사항 설명
jobName Yes String 영문 최소 3자 최대 20자까지 입력 생성할 Job 이름
notificationUrl No String Notification URL 참고 Notification을 callback 받을 URL
inputs[] Yes Array 변환할 영상에 필요한 값 배열
inputs[].inputContainerName Yes String 영문 최소 3자 최대 30자까지 입력 변환할 영상이 저장되어 있는File Storage Container 명
inputs[].inputFilePath Yes String "/", 확장자명(*.mp4) 포함 변환할 영상이 저장되어 있는 File Storage 경로를 포함한 파일명
e.g) /input/test.mp4
output Yes Object 출력물에 필요한 파라미터
output.outputContainerName Yes String 영문 최소 3자 최대 30자까지 입력 비디오 출력물을 저장할 File Storage Container 명
output.outputFilePath Yes String "/"로 시작, 영문 최소 3자 이상 10자까지 입력, 공백 허용 안 함 비디오 출력물을 저장할 상세 경로
output.thumbnailOn Yes String true, false 섬네일 이미지 생성 여부
output.thumbnailContainerName Conditional String 영문 최소 3자 최대 30자까지 입력
thumbnailOn: true일 시 필수 입력
섬네일 이미지를 저장할 File Storage Container 명
output.thumbnailFilePath Conditional String "/"로 시작, 영문 최소 3자 이상 10자까지 입력, 공백 허용 안 함
thumbnailOn: true일 시 필수 입력
섬네일 이미지를 저장할 상세 경로
output.outputFiles[] Yes Array 1개 인풋에 대해 최대 5개의 프리셋으로 변환 가능 output file에 필요한 파라미터
output.outputFiles[].presetId Yes String 영문, 숫자, "-" 허용 프리셋 ID
output.outputFiles[].outputFileName Yes String 영문 3자 이상 10자 이하 입력
공백 허용
출력된 파일 명

Request example

$ curl -i -X POST "https://vodtranscoder.apigw.ntruss.com/api/v1/jobs" \
 -H "Content-Type:application/json" \
 -H "x-ncp-apigw-timestamp:1521787414578" \
 -H "x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ" \
 -H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
 -H "x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=" \
 -d '{"jobName": "api-guide", "inputs": [{ "inputContainerName": "api-guide","inputFilePath": "/Sample.mp4"}],"output":{"outputContainerName": "api-guide","outputFilePath": "/vodtr/","thumbnailOn":"true","thumbnailContainerName": "api-guide","thumbnailFilePath":"/vodtr/","outputFiles": [{"presetId": "0dfd1eee-04c9-11e8-b51d-421453cae184","outputFileName": "720p"}]}}'
POST /api/v1/jobs
HOST: vodtranscoder.apigw.ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
Conent-Type: application/json

{"jobName": "api-guide", "inputs": [{ "inputContainerName": "api-guide","inputFilePath": "/Sample.mp4"}],"output":{"outputContainerName": "api-guide","outputFilePath": "/vodtr/","thumbnailOn":"true","thumbnailContainerName": "api-guide","thumbnailFilePath":"/vodtr/","outputFiles": [{"presetId": "0dfd1eee-04c9-11e8-b51d-421453cae184","outputFileName": "720p"}]}}

유의 사항

  • HTTP Request와 Response body를 통해 전달되는 모든 데이터의 content-type은 application/json을 사용합니다.
  • String 타입의 인풋 파라미터는 영문자와 - 특수 문자만 입력합니다(_ 특수 문자와 한글, 공백은 허용되지 않습니다).
  • inputFilePath: 만약 변환할 영상이 지정한 컨테이너 아래 있을 경우, /test.mp4와 같은 형태로, 반드시 /로 시작되어야 합니다.
  • outputFile name: 지정된 출력 경로(outputContainerName)에 같은 이름의 파일이 존재할 경우, 기존 파일에 덮어쓰는 것을 방지하기 위해 작업이 강제로 중단되며 상태 정보는 Fail로 바뀝니다.
  • 섬네일을 저장하지 않을 경우("thumbnailOn" : "false"), thumbnailContainerName, thumbnailFilePath 필드는 공란 허용되며 어떠한 값을 입력해도 무시됩니다.
  • 프리셋은 최대 5개까지 요청할 수 있습니다.
  • outputFilePath : 만약 별도 경로 지정 없이 입력한 컨테이너 아래 출력물을 저장하고 싶다면, / 만 입력하시면 됩니다.

Response field (JSON Object)

필드명 타입 설명 비고
jobs[] Array 생성된 Job 목록
jobs[].jobId String 생성된 JobId
error Object 응답 코드 및 메시지 VOD Transcoder API 에러 타입 참고
error.errorCode Integer 응답 코드(오류일 경우 오류 코드)
error.message String 응답 메시지(오류일 경우 오류 메시지)  

Response example

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 10:18:11 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 68d1o68pm4cr63gc3169gm4p34

{"jobs":[{"jobId":"ohkivb8pbqxxo5z8kayhn8pqnpnzmkbz"}],"error":{"errorCode":0,"message":"Ok"}}

Notification URL

Job 생성시 Notification URL을 등록해두면 Job 상태 변경(Progressing, Success, Failed)에 대한 콜백을 받을 수 있습니다. 선택 옵션이므로 반드시 설정할 필요는 없습니다.

이벤트가 발생하면 아래와 같은 형태로 callback 이 발송됩니다. (HTTP POST로 발송)

{
   "jobId" : "JOB_ID",
   "status" : "FAILED|PROGRESSING|SUCCESS"
}

Job 목록 조회

GET  https://vodtranscoder.apigw.ntruss.com/api/v1/jobs

Request header

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

Request example

$ curl -i "https://vodtranscoder.apigw.ntruss.com/api/v1/jobs?limit=1" \
 -H "x-ncp-apigw-timestamp:1521787414578" \
 -H "x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ" \
 -H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
 -H "x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M="
GET /api/v1/jobs?limit=1
HOST: vodtranscoder.apigw.ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

Response field (JSON Object)

필드명 타입 설명 비고
jobs[] Array 생성된 JobId 목록
jobs[].jobId String Job id
jobs[].jobName String Job name
jobs[].status String Job status
jobs[].jobErrorCode String Job error code
jobs[].createdTime Long Job 생성 시간
jobs[].submittedTime Long Job 등록 시간
jobs[].startedTime Long Job 시작 시간
jobs[].finishedTime Long Job 종료 시간
jobs[].storageType String 네이버 클라우드 플랫폼 스토리지 타입
jobs[].inputs[] Array 변환 대상인 원본 파일 관련 정보
jobs[].inputs[].inputFilePath String 변환 대상 파일 경로 경로+파일명
jobs[].inputs[].inputContainerName String 변환 대상 파일이 존재하는 컨테이너명
jobs[].inputs[].metadata Object 변환 대상 파일 속성
jobs[].inputs[].metadata.fileName String 변환 대상 파일명
jobs[].inputs[].metadata.fileSize Long 변환 대상 파일 사이즈
jobs[].inputs[].metadata.duration Float 변환 대상파일 재생시간
jobs[].inputs[].metadata.profile Object 변환 대상 파일 속성
jobs[].inputs[].metadata.profile.videoCodec String 변환 대상 비디오 코덱
jobs[].inputs[].metadata.profile.videoBitrate String 변환 대상 비디오 스트림의 비트 전송률
jobs[].inputs[].metadata.profile.profile String 변환 대상 비디오 코덱 프로파일
jobs[].inputs[].metadata.profile.level String 변환 대상 비디오 코덱 프로파일 레벨
jobs[].inputs[].metadata.profile.width Integer 변환 대상 비디오의 가로 길이
jobs[].inputs[].metadata.profile.height Integer 변환 대상 비디오의 세로 길이
jobs[].inputs[].metadata.profile.framerate String 변환 대상 초당 프레임 수
jobs[].inputs[].metadata.profile.keyframeInterval Integer 변환 대상 비디오 키 프레임 간격
비디오에 키 프레임 생성되는 간격
단위: 초
jobs[].inputs[].metadata.profile.audioCodec String 변환 대상 오디오 코덱
jobs[].inputs[].metadata.profile.audioBitrate String 변환 대상 오디오 스트림의 비트 전송률
jobs[].inputs[].metadata.profile.audioSamplingRate String 변환 대상 오디오 샘플링 레이트
jobs[].inputs[].metadata.profile.audioChannel Integer 변환 대상 오디오 채널 수
jobs[].inputs[].metadata.profile.containerFormat String 변환 대상 비디오 컨테이너 포맷
jobs[].output Object 변환된 파일 관련 정보
jobs[].output.outputFilePath String 변환된 파일 경로
jobs[].output.outputFiles[] Array 변환된 파일 목록
jobs[].output.outputFiles[].outputContainerName String 변환된 파일이 존재하는 컨테이너명
jobs[].output.outputFiles[].outputFilePath String 변환된 파일 경로
jobs[].output.outputFiles[].presetId String 변환에 사용된 Preset ID
jobs[].output.outputFiles[].metadata Object 변환된 파일 속성
jobs[].output.outputFiles[].metadata.fileName String 변환된 파일명
jobs[].output.outputFiles[].metadata.fileSize Long 변환된 파일 사이즈
jobs[].output.outputFiles[].metadata.duration Float 변환된 파일 재생시간
jobs[].output.outputFiles[].metadata.profile Object 변환된 파일 속성
jobs[].output.outputFiles[].metadata.profile.videoCodec String 변환된 파일 비디오 코덱
jobs[].output.outputFiles[].metadata.profile.videoBitrate String 변환된 파일 비디오 스트림의 비트 전송률
jobs[].output.outputFiles[].metadata.profile.profile String 변환된 파일 비디오 코덱 프로파일
jobs[].output.outputFiles[].metadata.profile.level String 변환된 파일 비디오 코덱 프로파일 레벨
jobs[].output.outputFiles[].metadata.profile.width Integer 변환된 파일 비디오 가로 길이
jobs[].output.outputFiles[].metadata.profile.height Integer 변환된 파일 비디오 세로 길이
jobs[].output.outputFiles[].metadata.profile.framerate String 변환된 파일 비디오 프레임
jobs[].output.outputFiles[].metadata.profile.keyframeInterval Integer 변환된 파일 비디오 키 프레임 간격 단위: 초
jobs[].output.outputFiles[].metadata.profile.audioCodec String 변환된 파일 오디오 코덱
jobs[].output.outputFiles[].metadata.profile.audioBitrate String 변환된 파일 오디오 스트림의 비트 전송률
jobs[].output.outputFiles[].metadata.profile.audioSamplingRate String 변환된 파일 오디오 샘플링 레이트
jobs[].output.outputFiles[].metadata.profile.audioChannel Integer 변환된 파일 오디오 채널 수
jobs[].output.outputFiles[].metadata.profile.containerFormat String 영상 포맷
jobs[].output.thumbnailOn String 섬네일 이미지 생성 여부
jobs[].output.thumbnailContainerName String 섬네일 이미지 저장 컨테이너명
jobs[].output.thumbnailFilePath String 섬네일 이미지 저장 경로
jobs[].output.thumbnailFileFormat String 섬네일 이미지 포맷
error Object 응답 코드 및 메시지 VOD Transcoder API 에러 타입 참고
error.errorCode Integer 응답 코드 (오류일 경우 오류 코드)
error.message String 응답 메시지 (오류일 경우 오류 메시지)  

기본적으로 모든 job을 응답하며, 아래 파라미터를 설정하여 원하는 조건에 맞춰 Job 목록을 조회할 수 있습니다.

파라미터 설명 제약 사항
startTime 조회 시작 날짜 초 단위 timestamp 이며 밀리초 단위 timestamp는 지원하지 않습니다
endTIme 조회 종료 날짜
endTime은 startTime으로부터 최대 3개월을 넘지 않아야 합니다.
초 단위 timestamp 이며 밀리초 단위 timestamp는 지원하지 않습니다
offset 전체 Job 목록 중 조회를 시작할 Job의 위치 제약 없음
limit 한 번에 조회할 Job의 갯수, 초기 값은 25 0~25

일정 기간 내 생성된 Job을 조회하고 싶을 경우

GET https://vodtranscoder.apigw.ntruss.com/api/v1/jobs?startTime=1520089200&endTime=1522767600

일정 기간 내 생성된 Job을 paging 처리하여 조회하고 싶을 때

  • 예시: 생성된 Job이 30개라면 페이지당 10개씩 노출되도록 Job 목록 조회
  • 참고: offset = { (paging number) - 1 } x limit
GET https://vodtranscoder.apigw.ntruss.com/api/v1/jobs?startTime=1520089200&endTime=1522767600&limit=10
GET https://vodtranscoder.apigw.ntruss.com/api/v1/jobs?startTime=1520089200&endTime=1522767600&limit=10&offset=1
GET https://vodtranscoder.apigw.ntruss.com/api/v1/jobs?startTime=1520089200&endTime=1522767600&limit=10&offset=2

Response example

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 10:20:21 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 3cc9hcpim4c9h62oj3cgo6ccr5

{"jobs":[{"jobId":"ohkivb8pbqxxo5z8kayhn8pqnpnzmkbz","createdTime":1536226046,"submittedTime":1536226046,"startedTime":1536226048,"finishedTime":1536226059,"status":"SUCCESS","jobErrorCode":"OK","storageType":"file","jobName":"api-guide","inputs":[{"metadata":{"fileName":"Sample.mp4","fileSize":411355012,"duration":600,"profile":{"videoCodec":"AVC","videoBitrate":"5120.0","profile":"","width":1920,"height":1080,"level":"","framerate":"23.976","keyframeInterval":0,"audioCodec":"AAC","audioBitrate":"320","audioSamplingRate":"48000.0","audioChannel":2,"containerFormat":"MPEG-4"}},"inputContainerName":"api-guide","inputFilePath":"/Sample.mp4"}],"output":{"outputContainerName":"api-guide","outputFilePath":"/vodtr/","thumbnailOn":"true","thumbnailContainerName":"api-guide","thumbnailFilePath":"/vodtr/","outputFiles":[{"presetId":"0dfd1eee-04c9-11e8-b51d-421453cae184","outputFileName":"720p.mp4","metadata":{"fileName":"720p.mp4","fileSize":194916970,"duration":600.666.0,"profile":{"videoCodec":"avc1","videoBitrate":"2433.0","profile":"","width":1280,"height":720,"level":"0","framerate":"30.0","keyframeInterval":0,"audioCodec":"AAC","audioBitrate":"160.0","audioSamplingRate":"44100.0","audioChannel":2,"containerFormat":""}}}]}}],"error":{"errorCode":0,"message":"Ok"}}

Job 정보 조회

특정 JobId를 가진 Job의 정보를 조회하는 API

GET https://vodtranscoder.apigw.ntruss.com/api/v1/jobs/{jobId}

Request header

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

Request example

$ curl -i "https://vodtranscoder.apigw.ntruss.com/api/v1/jobs/pglxuchlxr9lllshto9ujkzkb9ogormg" \
 -H "x-ncp-apigw-timestamp:1521787414578" \
 -H "x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ" \
 -H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
 -H "x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M="
GET /api/v1/jobs/pglxuchlxr9lllshto9ujkzkb9ogormg
HOST: vodtranscoder.apigw.ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

Response field (JSON Object)

Job 목록 조회의 응답 필드와 동일

필드명 타입 설명 비고
jobs[] Array 생성된 JobId 목록
jobs[].jobId String Job id
jobs[].jobName String Job name
jobs[].status String Job status
jobs[].jobErrorCode String Job error code
jobs[].createdTime Long Job 생성 시간
jobs[].submittedTime Long Job 등록 시간
jobs[].startedTime Long Job 시작 시간
jobs[].finishedTime Long Job 종료 시간
jobs[].storageType String 네이버 클라우드 플랫폼 스토리지 타입
jobs[].inputs[] Array 변환 대상인 원본 파일 관련 정보
jobs[].inputs[].inputFilePath String 변환 대상 파일 경로 경로+파일명
jobs[].inputs[].inputContainerName String 변환 대상 파일이 존재하는 컨테이너명
jobs[].inputs[].metadata Object 변환 대상 파일 속성
jobs[].inputs[].metadata.fileName String 변환 대상 파일명
jobs[].inputs[].metadata.fileSize Long 변환 대상 파일 사이즈
jobs[].inputs[].metadata.duration Float 변환 대상파일 재생시간
jobs[].inputs[].metadata.profile Object 변환 대상 파일 속성
jobs[].inputs[].metadata.profile.videoCodec String 변환 대상 비디오 코덱
jobs[].inputs[].metadata.profile.videoBitrate String 변환 대상 비디오 스트림의 비트 전송률
jobs[].inputs[].metadata.profile.profile String 변환 대상 비디오 코덱 프로파일
jobs[].inputs[].metadata.profile.level String 변환 대상 비디오 코덱 프로파일 레벨
jobs[].inputs[].metadata.profile.width Integer 변환 대상 비디오의 가로 길이
jobs[].inputs[].metadata.profile.height Integer 변환 대상 비디오의 세로 길이
jobs[].inputs[].metadata.profile.framerate String 변환 대상 초당 프레임 수
jobs[].inputs[].metadata.profile.keyframeInterval Integer 변환 대상 비디오 키 프레임 간격
비디오에 키 프레임 생성되는 간격
단위: 초
jobs[].inputs[].metadata.profile.audioCodec String 변환 대상 오디오 코덱
jobs[].inputs[].metadata.profile.audioBitrate String 변환 대상 오디오 스트림의 비트 전송률
jobs[].inputs[].metadata.profile.audioSamplingRate String 변환 대상 오디오 샘플링 레이트
jobs[].inputs[].metadata.profile.audioChannel Integer 변환 대상 오디오 채널 수
jobs[].inputs[].metadata.profile.containerFormat String 변환 대상 비디오 컨테이너 포맷
jobs[].output Object 변환된 파일 관련 정보
jobs[].output.outputFilePath String 변환된 파일 경로
jobs[].output.outputFiles[] Array 변환된 파일 목록
jobs[].output.outputFiles[].outputContainerName String 변환된 파일이 존재하는 컨테이너명
jobs[].output.outputFiles[].outputFilePath String 변환된 파일 경로
jobs[].output.outputFiles[].presetId String 변환에 사용된 Preset ID
jobs[].output.outputFiles[].metadata Object 변환된 파일 속성
jobs[].output.outputFiles[].metadata.fileName String 변환된 파일명
jobs[].output.outputFiles[].metadata.fileSize Long 변환된 파일 사이즈
jobs[].output.outputFiles[].metadata.duration Float 변환된 파일 재생시간
jobs[].output.outputFiles[].metadata.profile Object 변환된 파일 속성
jobs[].output.outputFiles[].metadata.profile.videoCodec String 변환된 파일 비디오 코덱
jobs[].output.outputFiles[].metadata.profile.videoBitrate String 변환된 파일 비디오 스트림의 비트 전송률
jobs[].output.outputFiles[].metadata.profile.profile String 변환된 파일 비디오 코덱 프로파일
jobs[].output.outputFiles[].metadata.profile.level String 변환된 파일 비디오 코덱 프로파일 레벨
jobs[].output.outputFiles[].metadata.profile.width Integer 변환된 파일 비디오 가로 길이
jobs[].output.outputFiles[].metadata.profile.height Integer 변환된 파일 비디오 세로 길이
jobs[].output.outputFiles[].metadata.profile.framerate String 변환된 파일 비디오 프레임
jobs[].output.outputFiles[].metadata.profile.keyframeInterval Integer 변환된 파일 비디오 키 프레임 간격 단위: 초
jobs[].output.outputFiles[].metadata.profile.audioCodec String 변환된 파일 오디오 코덱
jobs[].output.outputFiles[].metadata.profile.audioBitrate String 변환된 파일 오디오 스트림의 비트 전송률
jobs[].output.outputFiles[].metadata.profile.audioSamplingRate String 변환된 파일 오디오 샘플링 레이트
jobs[].output.outputFiles[].metadata.profile.audioChannel Integer 변환된 파일 오디오 채널 수
jobs[].output.outputFiles[].metadata.profile.containerFormat String 영상 포맷
jobs[].output.thumbnailOn String 섬네일 이미지 생성 여부
jobs[].output.thumbnailContainerName String 섬네일 이미지 저장 컨테이너명
jobs[].output.thumbnailFilePath String 섬네일 이미지 저장 경로
jobs[].output.thumbnailFileFormat String 섬네일 이미지 포맷
error Object 응답 코드 및 메시지 VOD Transcoder API 에러 타입 참고
error.errorCode Integer 응답 코드 (오류일 경우 오류 코드)
error.message String 응답 메시지 (오류일 경우 오류 메시지)  

Response example

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 10:20:21 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 3cc9hcpim4c9h62oj3cgo6ccr5

{"jobs":[{"jobId":"ohkivb8pbqxxo5z8kayhn8pqnpnzmkbz","createdTime":1536226046,"submittedTime":1536226046,"startedTime":1536226048,"finishedTime":1536226059,"status":"SUCCESS","jobErrorCode":"OK","storageType":"file","jobName":"api-guide","inputs":[{"metadata":{"fileName":"Sample.mp4","fileSize":411355012,"duration":600,"profile":{"videoCodec":"AVC","videoBitrate":"5120.0","profile":"","width":1920,"height":1080,"level":"","framerate":"23.976","keyframeInterval":0,"audioCodec":"AAC","audioBitrate":"320","audioSamplingRate":"48000.0","audioChannel":2,"containerFormat":"MPEG-4"}},"inputContainerName":"api-guide","inputFilePath":"/Sample.mp4"}],"output":{"outputContainerName":"api-guide","outputFilePath":"/vodtr/","thumbnailOn":"true","thumbnailContainerName":"api-guide","thumbnailFilePath":"/vodtr/","outputFiles":[{"presetId":"0dfd1eee-04c9-11e8-b51d-421453cae184","outputFileName":"720p.mp4","metadata":{"fileName":"720p.mp4","fileSize":194916970,"duration":600.666.0,"profile":{"videoCodec":"avc1","videoBitrate":"2433.0","profile":"","width":1280,"height":720,"level":"0","framerate":"30.0","keyframeInterval":0,"audioCodec":"AAC","audioBitrate":"160.0","audioSamplingRate":"44100.0","audioChannel":2,"containerFormat":""}}}]}}],"error":{"errorCode":0,"message":"Ok"}}

Job 생성 취소

생성된 Job을 취소하는 API (submitted 상태인 Job 만 생성 취소 가능)

POST https://vodtranscoder.apigw.ntruss.com/api/v1/{jobId}/cancel

Request header

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

Request example

$ curl -i -X POST "https://vodtranscoder.apigw.ntruss.com/api/v1/jobs/pglxuchlxr9lllshto9ujkzkb9ogormg" \
 -H "x-ncp-apigw-timestamp:1521787414578" \
 -H "x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ" \
 -H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
 -H "x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M="
POST /api/v1/jobs/pglxuchlxr9lllshto9ujkzkb9ogormg
HOST: vodtranscoder.apigw.ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

Response field

별도의 응답 메시지는 없으며 HTTP 응답 코드로 결과를 전달합니다.

HTTP 응답 코드 설명 비고
200 OK Job 생성이 취소됨  
400 Bad Request submitted 상태가 아닌 Job을 취소  

Response example

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 10:44:15 GMT
Content-Length: 0
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 3cc9hcpim4c9h62oj3cgo6ccr5

Preset Operation API

Custom 프리셋 생성

기본으로 제공되는 프리셋 외 Custom 프리셋을 생성하는 API

POST https://vodtranscoder.apigw.ntruss.com/api/v1/presets

Request header

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

Request field (JSON Object)

VOD Transcoder open api 요청시 필드명(key)은 대소문자 구분이 필요하며 입력값(value)은 대소문자를 구분하지 않습니다

필드명 필수 여부 타입 제약사항 설명
name Yes String 영어, 숫자, ":" 특수문자만 허용, 3자 이상 20자 이하 생성할 Custom preset의 이름
format Yes String 현재 mp4 포맷만 제공 변환된 파일의 비디오의 영상 포맷
audio Yes Object 트랜스코딩 오디오 옵션 설정 객체
audio.codec Yes String AAC만 제공 오디오 코덱 설정
audio.channel Yes String 1, 2 출력 오디오의 채널 설정
audio.bitrate Yes String 16~320 범위의 정수, 단위: Kbps 트랜스코딩할 오디오 스트림의 비트 전송률
audio.samplingRate Yes String 11025, 22050, 32000, 44100, 48000
단위: Hz
출력 오디오 샘플링 레이트 설정
video Yes Object 트랜스코딩 비디오 옵션 설정 객체
video.codec Yes String H264만 제공 비디오 옵션
video.codecOptions Yes Object 비디오 코덱 상세 옵션 설정 객체
video.codecOptions.profile Yes String BASELINE, MAIN, HIGH 영상의 사용 용도에 맞게 H.264 코덱의 특정 기술만을 사용할 수 있도록 모아둔 것이 profile 이며 이를 설정
video.codecOptions.level Yes String 1, 1b, 1.1,
1.2, 1.3,
2.1, 2.2,
3.1, 3.2,
4.1, 4.2,
5.1, 5.2
영상을 재생하는 단말의 재생기(디코더)가 어느 정도의 자원을 필요로 하는지 정해놓은 명세이며 이를 설정
video.bitrate Yes String bitrate > 0
단위: Kbps
비디오 스트림의 비트 전송률 설정
동영상의 화질을 결정하는 매우 중요한 요소이며 1초 분량의 동영상을 구성하는 데이터의 크기를 설정
video.width Yes String 128~4096 범위의 정수
단위: 픽셀
출력 비디오의 가로 길이
video.height Yes String 96~3072 범위의 정수
단위: 픽셀
출력 비디오의 세로 길이
video.framerate Yes String 10, 15, 23.97, 24, 29.97, 30, 50, 60 초당 프레임 수를 설정
출력 비디오 스트림에 초당 몇 개의 프레임을 보여 줄지 설정
video.keyframeInterval Yes String 1~100000 범위의 정수 키프레임 간격 설정
비디오에 키 프레임 생성되는 간격을 설정
예를들어, framerate="30", keyframeInterval="2" 설정시 60 frame마다 key frame이 생성되며
간격이 작을수록 비디오 품질향상

Request example

$ curl -i -X POST "https://vodtranscoder.apigw.ntruss.com/api/v1/presets" \
 -H "Content-Type:application/json" \
 -H "x-ncp-apigw-timestamp:1521787414578" \
 -H "x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ" \
 -H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
 -H "x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=" \
 -d '{"name": "custom240p","format": "MP4","audio": {"codec": "AAC","channel": "2","bitrate": "64","samplingRate": "44100"},"video": {"codec": "H264","codecOptions": {"profile": "BASELINE","level": "3.1"},"bitrate": "300","width": "320","height": "240","framerate": "30","keyframeInterval": "2"}}'
POST /api/v1/presets
HOST:vodtranscoder.apigw.ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
Conent-Type: application/json

{"name": "custom240p","format": "MP4","audio": {"codec": "AAC","channel": "2","bitrate": "64","samplingRate": "44100"},"video": {"codec": "H264","codecOptions": {"profile": "BASELINE","level": "3.1"},"bitrate": "300","width": "320","height": "240","framerate": "30","keyframeInterval": "90"}}

Response field (JSON Object)

필드명 타입 설명 비고
presetOverviewList[] Array 생성된 Preset 목록
presetOverviewList[].presetId String 생성된 Preset Id
presetOverviewList[].presetGroup String Preset group custom으로 지정
presetOverviewList[].presetType String Preset type
presetOverviewList[].presetCostType String Cost type
presetOverviewList[].presetName String 설정한 Preset name
presetOverviewList[].createTime Long 생성시간 timestamp in seconds
presetOverviewList[].profile Object 설정한 Video/Audio Profile 정보
presetOverviewList[].profile.videoCodec String Video codec
presetOverviewList[].profile.videoBitrate String Video bitrate
presetOverviewList[].profile.profile String Codec profile
presetOverviewList[].profile.level String Codec profile level
presetOverviewList[].profile.width Integer Video width
presetOverviewList[].profile.height Integer Video height
presetOverviewList[].profile.framerate String Video framerate
presetOverviewList[].profile.keyframeInterval Integer Video keyframe interval 단위: 초
presetOverviewList[].profile.audioCodec String Audio codec
presetOverviewList[].profile.audioBitrate String Audio bitrate
presetOverviewList[].profile.audioSamplingRate String Audio sampling rate
presetOverviewList[].profile.audioChannel Integer Audio Channel
presetOverviewList[].profile.containerFormat String 영상 포맷
error String 응답 코드 및 메시지 VOD Transcoder API 에러 타입 참고
error.errorCode Integer 응답 코드 (오류일 경우 오류 코드)
error.message String 응답 메시지 (오류일 경우 오류 메시지)  

Response example

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 10:00:21 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 68oplclgm2d9i3epb464q6cob5

{"presetOverviewList":[{"presetId":"a926a890-b672-11e8-89b0-421453cae184","presetGroup":"custom","presetType":"240P","presetCostType":"SD","presetName":"custom240p","createTime":1536746421,"profile":{"videoCodec":"H264","videoBitrate":"300","profile":"BASELINE","width":320,"height":240,"level":"3.1","framerate":"30","keyframeInterval":90,"audioCodec":"AAC","audioBitrate":"64","audioSamplingRate":"44100","audioChannel":2,"containerFormat":"mp4"}}],"error":{"errorCode":0,"message":"success"}}

프리셋 목록 조회

사용 가능한 모든 프리셋 목록을 조회하는 API

GET https://vodtranscoder.apigw.ntruss.com/api/v1/presets

Request header

헤더명 설명
x-ncp-apigw-timestamp 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(millisecond)로 나타내며 APIGW 서버와 시간차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
'x-ncp-apigw-timestamp:{Timestamp}'
x-ncp-apigw-api-key API Gateway에서 발급받은 키
x-ncp-apigw-api-key:{API Gateway API Key}
x-ncp-iam-access-key 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID
x-ncp-iam-access-key:{Sub Account Access Key}
x--ncp-apigw-signature-v1 Access Key ID와 맵핑되는 Secret Key로 암호화한 서명
HMAC 암호화 알고리즘은 HmacSHA256 사용
x-ncp-apigw-signature-v1:{API Gateway Signature}

Request example

$ curl -i "https://vodtranscoder.apigw.ntruss.com/api/v1/presets" \
 -H "x-ncp-apigw-timestamp:1521787414578" \
 -H "x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ" \
 -H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
 -H "x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M="
GET /api/v1/presets
HOST: vodtranscoder.apigw.ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

Response field (JSON Object)

필드명 타입 설명 비고
presetOverviewList[] Array 생성된 Preset 목록
presetOverviewList[].presetId String 생성된 Preset Id
presetOverviewList[].presetGroup String Preset group custom으로 지정
presetOverviewList[].presetType String Preset type
presetOverviewList[].presetCostType String Cost type
presetOverviewList[].presetName String 설정한 Preset name
presetOverviewList[].createTime Long 생성시간 timestamp in seconds
presetOverviewList[].profile Object 설정한 Video/Audio Profile 정보
presetOverviewList[].profile.videoCodec String Video codec
presetOverviewList[].profile.videoBitrate String Video bitrate
presetOverviewList[].profile.profile String Codec profile
presetOverviewList[].profile.level String Codec profile level
presetOverviewList[].profile.width Integer Video width
presetOverviewList[].profile.height Integer Video height
presetOverviewList[].profile.framerate String Video framerate
presetOverviewList[].profile.keyframeInterval Integer Video keyframe interval 단위: 초
presetOverviewList[].profile.audioCodec String Audio codec
presetOverviewList[].profile.audioBitrate String Audio bitrate
presetOverviewList[].profile.audioSamplingRate String Audio sampling rate
presetOverviewList[].profile.audioChannel Integer Audio Channel
presetOverviewList[].profile.containerFormat String 영상 포맷
responseStatus String 응답 상태 메시지 OK

Response example

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{"presetOverviewList":[{"presetId":"0dd0decd-04c9-11e8-b51d-421453cae184","presetGroup":"system","presetType":"240P","presetCostType":"SD","presetName":"Generic 320x240","createTime":0,"profile":{"videoCodec":"H264","videoBitrate":"300","profile":"BASELINE","width":320,"height":240,"level":"1.3","framerate":"15.0","keyframeInterval":90,"audioCodec":"AAC","audioBitrate":"64","audioSamplingRate":"22050","audioChannel":2}},{"presetId":"283a0b36-4856-11e8-89b0-421453cae184","presetGroup":"system","presetType":"240P","presetCostType":"SD","presetName":"Generic 777p 4:3","createTime":0,"profile":{"videoCodec":"H264","videoBitrate":"300","profile":"BASELINE","width":320,"height":240,"level":"1.3","framerate":"60.0","keyframeInterval":90,"audioCodec":"AAC","audioBitrate":"64","audioSamplingRate":"22050","audioChannel":2}}], "responseStatus":"OK"}

프리셋 정보 조회

특정 presetId를 가진 프리셋을 조회하는 API

GET https://vodtranscoder.apigw.ntruss.com/api/v1/preset/{presetId}

Request header

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

Request example

$ curl -i "https://vodtranscoder.apigw.ntruss.com/api/v1/presets/8d24bc1c-b66f-11e8-89b0-421453cae184" \
 -H "x-ncp-apigw-timestamp:1521787414578" \
 -H "x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ" \
 -H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
 -H "x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M="
GET /api/v1/presets/8d24bc1c-b66f-11e8-89b0-421453cae184
HOST: vodtranscoder.apigw.ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

Response field (JSON Object)

Preset 목록 조회의 응답 필드와 동일

필드명 타입 설명 비고
presetOverviewList[] Array 생성된 Preset 목록
presetOverviewList[].presetId String 생성된 Preset Id
presetOverviewList[].presetGroup String Preset group custom으로 지정
presetOverviewList[].presetType String Preset type
presetOverviewList[].presetCostType String Cost type
presetOverviewList[].presetName String 설정한 Preset name
presetOverviewList[].createTime Long 생성시간 timestamp in seconds
presetOverviewList[].profile Object 설정한 Video/Audio Profile 정보
presetOverviewList[].profile.videoCodec String Video codec
presetOverviewList[].profile.videoBitrate String Video bitrate
presetOverviewList[].profile.profile String Codec profile
presetOverviewList[].profile.level String Codec profile level
presetOverviewList[].profile.width Integer Video width
presetOverviewList[].profile.height Integer Video height
presetOverviewList[].profile.framerate String Video framerate
presetOverviewList[].profile.keyframeInterval Integer Video keyframe interval 단위: 초
presetOverviewList[].profile.audioCodec String Audio codec
presetOverviewList[].profile.audioBitrate String Audio bitrate
presetOverviewList[].profile.audioSamplingRate String Audio sampling rate
presetOverviewList[].profile.audioChannel Integer Audio Channel
presetOverviewList[].profile.containerFormat String 영상 포맷
responseStatus String 응답 상태 메시지 OK

Response example

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{"presetOverviewList":[{"presetId":"0dd0decd-04c9-11e8-b51d-421453cae184","presetGroup":"system","presetType":"240P","presetCostType":"SD","presetName":"Generic 320x240","createTime":0,"profile":{"videoCodec":"H264","videoBitrate":"300","profile":"BASELINE","width":320,"height":240,"level":"1.3","framerate":"15.0","keyframeInterval":90,"audioCodec":"AAC","audioBitrate":"64","audioSamplingRate":"22050","audioChannel":2}}], "responseStatus":"OK"}

Custom 프리셋 삭제

생성한 Custom 프리셋을 삭제하는 API

DELETE https://vodtranscoder.apigw.ntruss.com/api/v1/preset/{presetId}

Request header

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

Request example

$ curl -i -X DELETE "https://vodtranscoder.apigw.ntruss.com/api/v1/presets/8d24bc1c-b66f-11e8-89b0-421453cae184" \
 -H "x-ncp-apigw-timestamp:1521787414578" \
 -H "x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ" \
 -H "x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy" \
 -H "x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M="
DELETE /api/v1/presets/8d24bc1c-b66f-11e8-89b0-421453cae184
HOST: vodtranscoder.apigw.ntruss.com
x-ncp-apigw-timestamp:1521787414578
x-ncp-apigw-api-key:AKLJsfKIy12AJDW0Q2MxANdoiAZKxWwG3NOvT6aZ
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v1:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=

Response field (JSON Object)

필드명 타입 설명 비고
error Object 응답 코드 및 메시지 "VOD Transcoder API 에러 타입" 참고
error.errorCode Integer 응답 코드 (오류일 경우 오류 코드)
error.message String 응답 메시지 (오류일 경우 오류 메시지)  

Response example

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 10:00:21 GMT
Content-Type: application/json;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 68oplclgm2d9i3epb464q6cob5

{"error": {"errorCode": 0,"message": "Success"}}

""에 대한 건이 검색되었습니다.

    ""에 대한 검색 결과가 없습니다.

    처리중...