카테고리 상태 정보 조회
    • 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-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://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
            }
          }
        ]
      }
    }
    

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

    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.