MENU
      카테고리 상태 정보 조회

        카테고리 상태 정보 조회


        기사 요약

        VOD Station은 카테고리들의 인코딩 상태 정보를 조회하기 위한 API를 제공합니다.

        요청

        GET https://vodstation.apigw.ntruss.com/api/v2/status/{fileId}
        HTTP

        요청 헤더

        헤더명설명
        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-v2Access Key ID 값과 Secret Key로 암호화한 서명
        x-ncp-apigw-signature-v2:{API Gateway Signature}

        응답

        필드명타입설명비고
        errorObject요청 실패 시 응답
        오류 응답 코드 및 메시지
        error.codeInteger오류 응답 코드
        error.messageString오류 응답 메시지
        contentObjectVOD Station OPEN API 응답 객체
        content.categoryIdString카테고리 ID
        content.categoryNameString카테고리 이름
        content.inputObject입력 파일 객체
        content.input.fileIdInteger입력 파일 ID
        content.input.bucketNameString입력 파일 버킷 이름
        content.input.filePathString입력 파일 경로
        content.input.metadataObject입력 파일 메타데이터 객체
        content.input.metadata.durationFloat파일 재생 시간 (단위 : 초)
        content.input.metadata.videoCodecString비디오 코덱
        content.input.metadata.videoBitrateFloat비디오 비트레이트 (단위 : Kbps)
        content.input.metadata.profileString비디오 프로파일
        content.input.metadata.widthInteger비디오 넓이
        content.input.metadata.heightInteger비디오 높이
        content.input.metadata.framerateString비디오 프레임레이트
        content.input.metadata.audioCodecString오디오 코덱
        content.input.metadata.audioBitrateFloat오디오 비트레이트 (단위 : Kbps)
        content.input.metadata.audioSamplingRateFloat오디오 샘플링레이트 (단위 : Hz)
        content.input.metadata.audioChannelInteger오디오 채널
        content.output[]Array(Object)출력 파일 정보
        content.output[].encodingOptionIdInteger인코딩 옵션 ID
        content.output[].outputTypeString아웃풋 타입 정보
        content.output[].objectStorageUrlStringObjectstorage 다운로드 URL
        content.output[].fileSizeByteLong출력 파일 크기 (단위 : byte)
        content.output[].statusString인코딩 결과 상태COMPLETE, WAITING, RUNNING, FAILURE, CANCELED
        content.output[].percentageInteger인코딩 진행도
        content.output[].metadataObject출력 파일 메타데이터
        content.output[].metadata.durationFloat파일 재생 시간 (단위 : 초)
        content.output[].metadata.videoCodecString비디오 코덱
        content.output[].metadata.videoBitrateFloat비디오 비트레이트 (단위 : Kbps)
        content.output[].metadata.videoPassString비디오 프로파일
        content.output[].metadata.widthInteger비디오 넓이
        content.output[].metadata.heightInteger비디오 높이
        content.output[].metadata.framerateString비디오 프레임레이트
        content.output[].metadata.audioCodecString오디오 코덱
        content.output[].metadata.audioBitrateFloat오디오 비트레이트 (단위 : Kbps)
        content.output[].metadata.audioSamplingRateFloat오디오 샘플링레이트 (단위 : Hz)
        content.output[].metadata.audioChannelInteger오디오 채널

        예시

        요청 예시

        GET https://vodstation.apigw.ntruss.com/api/v2/status/10099
        
        GET /api/v2/status/10099
        HOST: vodstation.apigw.ntruss.com
        x-ncp-apigw-timestamp:1521787414578
        x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
        x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M==
        HTTP

        응답 예시

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

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.