카테고리 상태 정보 조회

Prev Next

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
        }
      }
    ]
  }
}