카테고리 상태 조회

Prev Next

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

카테고리별 인코딩 상태에 대한 상세 정보를 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
GET /api/v2/status/{fileId}

요청 헤더

VOD Station API에서 공통으로 사용하는 헤더에 대한 정보는 VOD Station 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
fileId String Required 파일 아이디

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://vodstation.apigw.ntruss.com/api/v2/status/1*****4' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드 타입 필수 여부 설명
content Object - 응답 결과
categoryId Integer - 카테고리 아이디
categoryName String - 카테고리 이름
content.input Object - 입력 파일 정보
content.input.fileId Integer - 입력 파일 아이디
content.input.bucketName String - 입력 파일이 저장되어 있는 버킷 이름
content.input.filePath String - 파일명을 포함한 입력 파일의 버킷 상세 경로
content.input.metadata Object - 입력 파일 메타데이터 정보
content.input.metadata.duration Float - 파일 재생 시간(초)
  • SS.SS 형식
content.input.metadata.videoCodec String - 비디오 코덱
content.input.metadata.videoBitrate Float - 비디오 비트레이트(Kbps)
content.input.metadata.width Integer - 비디오 너비(픽셀)
content.input.metadata.height Integer - 비디오 높이(픽셀)
content.input.metadata.framerate Float - 초당 프레임 수(fps)
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 - 출력 파일 정보: output

output

output에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
encodingOptionId Integer - 인코딩 옵션 아이디
outputType String - 출력 타입
objectStorageUrl String - 파일명을 포함한 출력 파일의 HTTP URL 경로
status String - 파일 인코딩 상태
  • COMPLETE | WAITING | RUNNING | FAILURE
    • COMPLETE: 완료
    • WAITING: 대기
    • RUNNING: 진행 중
    • FAILURE: 실패
percentage Float - 파일 인코딩 진행률(%)
metadata Object - 출력 파일 메타데이터
metadata.duration Float - 파일 재생 시간(초)
  • SS.SS 형식
metadata.videoCodec String - 비디오 코덱
metadata.videoPass String - 비디오 패스
metadata.videoBitrate Float - 비디오 비트레이트(Kbps)
metadata.width Integer - 비디오 너비(픽셀)
metadata.height Integer - 비디오 높이(픽셀)
metadata.framerate Float - 초당 프레임 수(fps)
metadata.audioCodec String - 오디오 코덱
metadata.audioBitrate Float - 오디오 비트레이트(Kbps)
metadata.audioSamplingRate Float - 오디오 샘플링레이트(Hz)
metadata.audioChannel Integer - 오디오 채널

응답 상태 코드

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

응답 예시

응답 예시는 다음과 같습니다.

{
    "content": {
        "categoryId": *****,
        "categoryName": "VOD-Callback",
        "input": {
            "fileId": 1*****4,
            "metadata": {
                "duration": 8.043,
                "videoCodec": "AVC",
                "videoBitrate": 2667520.0,
                "width": 1280,
                "height": 720,
                "framerate": 24.0,
                "audioCodec": "AAC",
                "audioBitrate": 143360.0,
                "audioSamplingRate": 48000.0,
                "audioChannel": 2
            }
        },
        "output": [
            {
                "encodingOptionId": 1,
                "outputType": "AVC_SD_1Pass_30fps",
                "objectStorageUrl": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_SD_1Pass_30fps.mp4",
                "status": "COMPLETE",
                "percentage": 100.0,
                "metadata": {
                    "duration": 8.047,
                    "videoCodec": "avc1",
                    "videoPass": "ONE_PASS",
                    "videoBitrate": 478208.0,
                    "width": 480,
                    "height": 270,
                    "framerate": 24.0,
                    "audioCodec": "AAC LC",
                    "audioBitrate": 132096.0,
                    "audioSamplingRate": 44100.0,
                    "audioChannel": 2
                }
            },
            {
                "encodingOptionId": 2,
                "outputType": "AVC_SD_1Pass_30fps_1",
                "objectStorageUrl": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_SD_1Pass_30fps_1.mp4",
                "status": "COMPLETE",
                "percentage": 100.0,
                "metadata": {
                    "duration": 8.047,
                    "videoCodec": "avc1",
                    "videoPass": "ONE_PASS",
                    "videoBitrate": 872448.0,
                    "width": 854,
                    "height": 480,
                    "framerate": 24.0,
                    "audioCodec": "AAC LC",
                    "audioBitrate": 132096.0,
                    "audioSamplingRate": 44100.0,
                    "audioChannel": 2
                }
            },
            {
                "encodingOptionId": 3,
                "outputType": "AVC_HD_1Pass_30fps",
                "objectStorageUrl": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_HD_1Pass_30fps.mp4",
                "status": "COMPLETE",
                "percentage": 100.0,
                "metadata": {
                    "duration": 8.047,
                    "videoCodec": "avc1",
                    "videoPass": "ONE_PASS",
                    "videoBitrate": 1737728.0,
                    "width": 1280,
                    "height": 720,
                    "framerate": 24.0,
                    "audioCodec": "AAC LC",
                    "audioBitrate": 132096.0,
                    "audioSamplingRate": 44100.0,
                    "audioChannel": 2
                }
            }
        ]
    }
}