카테고리 상태 정보 조회
- 인쇄
- PDF
카테고리 상태 정보 조회
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VOD Station은 카테고리들의 인코딩 상태 정보를 조회하기 위한 API를 제공합니다.
요청
GET https://vod-station.apigw.gov-ntruss.com/api/v2/status/{fileId}
요청 헤더
헤더명 | 설명 |
---|---|
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 | Object | VOD Station OPEN API 응답 객체 | |
content.categoryId | String | 카테고리 ID | |
content.categoryName | String | 카테고리 이름 | |
content.input | Object | 입력 파일 객체 | |
content.input.fileId | Integer | 입력 파일 ID | |
content.input.bucketName | String | 입력 파일 버킷 이름 | |
content.input.filePath | String | 입력 파일 경로 | |
content.input.metadata | Object | 입력 파일 메타데이터 객체 | |
content.input.metadata.duration | Float | 파일 재생 시간 (단위 : 초) | |
content.input.metadata.videoCodec | String | 비디오 코덱 | |
content.input.metadata.videoBitrate | Float | 비디오 비트레이트 (단위 : Kbps) | |
content.input.metadata.profile | String | 비디오 프로파일 | |
content.input.metadata.width | Integer | 비디오 넓이 | |
content.input.metadata.height | Integer | 비디오 높이 | |
content.input.metadata.framerate | String | 비디오 프레임레이트 | |
content.input.metadata.audioCodec | String | 오디오 코덱 | |
content.input.metadata.audioBitrate | Float | 오디오 비트레이트 (단위 : Kbps) | |
content.input.metadata.audioSamplingRate | Float | 오디오 샘플링레이트 (단위 : Hz) | |
content.input.metadata.audioChannel | Integer | 오디오 채널 | |
content.output[] | Array(Object) | 출력 파일 정보 | |
content.output[].encodingOptionId | Integer | 인코딩 옵션 ID | |
content.output[].outputType | String | 아웃풋 타입 정보 | |
content.output[].objectStorageUrl | String | Objectstorage 다운로드 URL | |
content.output[].fileSizeByte | Long | 출력 파일 크기 (단위 : byte) | |
content.output[].status | String | 인코딩 결과 상태 | COMPLETE, WAITING, RUNNING, FAILURE, CANCELED |
content.output[].percentage | Integer | 인코딩 진행도 | |
content.output[].metadata | Object | 출력 파일 메타데이터 | |
content.output[].metadata.duration | Float | 파일 재생 시간 (단위 : 초) | |
content.output[].metadata.videoCodec | String | 비디오 코덱 | |
content.output[].metadata.videoBitrate | Float | 비디오 비트레이트 (단위 : Kbps) | |
content.output[].metadata.videoPass | String | 비디오 프로파일 | |
content.output[].metadata.width | Integer | 비디오 넓이 | |
content.output[].metadata.height | Integer | 비디오 높이 | |
content.output[].metadata.framerate | String | 비디오 프레임레이트 | |
content.output[].metadata.audioCodec | String | 오디오 코덱 | |
content.output[].metadata.audioBitrate | Float | 오디오 비트레이트 (단위 : Kbps) | |
content.output[].metadata.audioSamplingRate | Float | 오디오 샘플링레이트 (단위 : Hz) | |
content.output[].metadata.audioChannel | Integer | 오디오 채널 |
예시
요청 예시
GET https://vod-station.apigw.gov-ntruss.com/api/v2/status/10099
GET /api/v2/status/10099
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": {
"categoryId": 10221,
"categoryName": "openapi-guide",
"input": {
"fileId": 10099,
"bucketName": "vodstation",
"filePath": "openapi-guide.mov",
"metadata": {
"duration": 10.01,
"videoCodec": "MPEG Video",
"videoBitrate": 5871616,
"width": 1280,
"height": 720,
"framerate": 59.94,
"audioCodec": "PCM",
"audioBitrate": 786432,
"audioSamplingRate": 48000,
"audioChannel": 1
}
},
"output": [
{
"encodingOptionId": 3,
"outputType": "AVC_HD_1Pass_30fps",
"objectStorageUrl": "https://kr.object.ncloudstorage.com/test-vod/add-files-test/openapi-guide/openapi-guide_AVC_HD_1Pass_30fps.mp4",
"status": "COMPLETE",
"metadata": {
"duration": 10.057,
"videoCodec": "avc1",
"videoPass": "ONE_PASS",
"videoBitrate": 188416,
"width": 1280,
"height": 720,
"framerate": 30,
"audioCodec": "AAC",
"audioBitrate": 131072,
"audioSamplingRate": 44100,
"audioChannel": 2
}
},
{
"encodingOptionId": 1,
"outputType": "AVC_SD_1Pass_30fps",
"objectStorageUrl": "https://kr.object.ncloudstorage.com/test-vod/add-files-test/openapi-guide/openapi-guide_AVC_SD_1Pass_30fps.mp4",
"status": "COMPLETE",
"metadata": {
"duration": 10.057,
"videoCodec": "avc1",
"videoPass": "ONE_PASS",
"videoBitrate": 195584,
"width": 480,
"height": 270,
"framerate": 30,
"audioCodec": "AAC",
"audioBitrate": 131072,
"audioSamplingRate": 44100,
"audioChannel": 2
}
},
{
"encodingOptionId": 2,
"outputType": "AVC_SD_1Pass_30fps_1",
"objectStorageUrl": "https://kr.object.ncloudstorage.com/test-vod/add-files-test/openapi-guide/openapi-guide_AVC_SD_1Pass_30fps_1.mp4",
"status": "COMPLETE",
"metadata": {
"duration": 10.057,
"videoCodec": "avc1",
"videoPass": "ONE_PASS",
"videoBitrate": 253952,
"width": 854,
"height": 480,
"framerate": 30,
"audioCodec": "AAC",
"audioBitrate": 131072,
"audioSamplingRate": 44100,
"audioChannel": 2
}
}
]
}
}
이 문서가 도움이 되었습니까?