카테고리 파일 추가
    • PDF

    카테고리 파일 추가

    • PDF

    기사 요약

    VOD Station은 카테고리에 인코딩 파일을 추가하기 위한 API를 제공합니다.

    요청

    PUT https://vod-station.apigw.gov-ntruss.com/api/v2/category/{categoryId}/add-files
    

    요청 헤더

    헤더명설명
    x-ncp-apigw-timestamp1970년 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}
    Content-TypeRequest body content type을 application/json으로 지정
    Content-Type: application/json

    요청 바디

    API 요청 시 필드명의 대소문자 구분이 필요합니다.

    필드명필수 여부타입제약 사항기본 값설명
    bucketNameYesString입력 파일이 업로드 되어있는 버킷 이름, httpDownload URL 혹은 bucketName, filePath 를 입력해야합니다.
    pathListYesArray(String)100개 이하 입력 파일 지원파일명을 포함한 입력 파일의 상세 경로, httpDownload URL 혹은 bucketName, filePath 를 입력해야 합니다.
    httpDownloadUrlListYesArray(String)100개 이하 입력 파일 지원,
    http url 형식,
    AVI, MOV, MP4, MP3, 3GP, MPG, MPEG, M4V, VOB, WMV, ASF, MKV, FLV, WEBM, GIF, AV1, MXF 확장자만 입력받음
    파일명을 포함한 입력 파일의 상세 경로, httpDownload URL 혹은 bucketName, filePath 를 입력해야합니다.
    notificationUrlNoString입력 파일에 대한 Callback URL 설정 (Overwrite Category notificationUrl Field)
    outputNoObject입력 파일에 대한 출력 설정 (Overwrite Category output Field)
    output.bucketNameYesString출력 버킷 이름
    output.filePathYesString출력 파일을 업로드 할 상세 경로
    output.thumbnailBucketNameOptionalString입력하지 않을 시 카테고리 설정을 따름썸네일 출력 버킷 이름
    output.thumbnailFilePathOptionalString입력하지 않을 시 카테고리 설정을 따름
    최소 1자, 최대 256자까지 입력 (영문, 숫자, < > : " / \ ? * % 제외 특수문자 허용)
    썸네일 출력 파일을 업로드 할 상세 경로
    output.accessControlNoStringPUBLIC_READ, PRIVATEPRIVATE출력 파일의 공개 범위
    output.thumbnailAccessControlNoStringPUBLIC_READ, PRIVATEPRIVATE출력 썸네일의 공개 범위
    output.withoutCategoryNameNoBooleantrue, falsefalseOutput 출력 경로에 카테고리 명의 폴더 생성 유무
    setAdvancedOptionsNoBooleantrue, falsefalse고급 설정 별도 설정 여부
    advancedOptionsNoObjectNULL고급 설정
    advancedOptions.trimmingNoObjectNULL출력 파일 트리밍 설정
    advancedOptions.trimming.startTimeCodeYesString포맷: "HH:MM:SS.S"- 트리밍 시작 시점
    타임코드 포맷에 맞춰 값 입력
    advancedOptions.trimming.endTimeCodeYesString포맷: "HH:MM:SS.S",
    startTimeCode보다 작은 값 입력 불가
    - 트리밍 종료 시점
    타임코드 포맷에 맞춰 값 입력
    advancedOptions.imageOverlayNoObjectNULL이미지 오버레이 설정
    advancedOptions.imageOverlay.inputYesObject입력 이미지
    advancedOptions.imageOverlay.input.bucketNameYesString입력 이미지가 업로드 되어있는 버킷 이름
    advancedOptions.imageOverlay.input.filePathYesString파일명을 포함한 입력 이미지의 상세 경로
    advancedOptions.imageOverlay.positionYesObject삽입할 이미지 위치 설정
    advancedOptions.imageOverlay.position.xYesIntegerx 축 위치
    advancedOptions.imageOverlay.position.yYesIntegery 축 위치
    advancedOptions.imageOverlay.sizeYesObejct삽입할 이미지 크기 설정
    advancedOptions.imageOverlay.size.widthYesInteger이미지 너비
    advancedOptions.imageOverlay.size.heightYesInteger이미지 높이

    응답

    필드명타입설명비고
    content[]Array(Object)VOD Station OPEN API 응답 객체
    content[].idInteger파일 인코딩 작업 ID
    content[].bucketNameString입력 파일이 업로드 되어있는 버킷 이름
    content[].pathListArray(String)파일명을 포함한 입력 파일의 상세 경로
    content[].httpDownloadUrlArray(String)외부로부터 다운로드 받을 HTTP URL
    content[].statusString파일 인코딩 상태COMPLETE, WAITING, RUNNING, FAILURE, CANCELED
    content[].notificationUrlStringCallback URL 설정
    content[].outputObject출력 설정
    content[].output.bucketNameString출력 버킷 이름
    content[].output.filePathString입력 파일을 업로드 할 상세 경로
    content[].output.thumbnailBucketNameString썸네일 출력 버킷 이름
    content[].output.thumbnailFilePathString썸네일 출력 출력 파일 업로드 상세경로
    content[].output.accessControlString출력 파일의 공개 범위
    content[].output.thumbnailAccessControlString출력 썸네일의 공개 범위
    content[].output.withoutCategoryNameBooleanOutput 출력 경로에 카테고리 명의 폴더 생성 유무
    content[].advancedOptionsObject고급 설정
    content[].advancedOptions.trimmingObject출력 파일 트리밍 설정
    content[].advancedOptions.trimming.startTimeCodeString트리밍 시작 시점
    content[].advancedOptions.trimming.endTimeCodeString트리밍 종료 시점
    content[].advancedOptions.imageOverlayObject이미지 오버레이 설정
    content[].advancedOptions.imageOverlay.inputObject입력 이미지
    content[].advancedOptions.imageOverlay.input.bucketNameString입력 이미지가 업로드 되어있는 버킷 이름
    content[].advancedOptions.imageOverlay.input.filePathString입력 이미지의 상세 경로
    content[].advancedOptions.imageOverlay.positionObject삽입할 이미지 위치 설정
    content[].advancedOptions.imageOverlay.position.xIntegerx축 위치
    content[].advancedOptions.imageOverlay.position.yIntegery축 위치
    content[].advancedOptions.imageOverlay.sizeObejct삽입할 이미지 크기 설정
    content[].advancedOptions.imageOverlay.size.widthInteger이미지 너비
    content[].advancedOptions.imageOverlay.size.heightInteger이미지 높이

    예시

    요청 예시

    PUT https://vod-station.apigw.gov-ntruss.com/api/v2/category/10095/add-files
    
    PUT /api/v2/category/10095/add-files
    HOST: vod-station.apigw.gov-ntruss.com
    Content-Type: application/json
    x-ncp-apigw-timestamp:1521787414578
    x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
    x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M==
    
    {
      "bucketName": "vs-input",
      "pathList": [
        "SampleVideo_1280x720_5mb.mp4", "/1-path/SampleVideo_1920x1080_5m.mp4"
      ]
    }
    

    응답 예시

    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": [
        {
          "id": 10240,
          "bucketName": "vs-input",
          "filePath": "SampleVideo_1280x720_5mb.mp4",
          "status": "WAITING"
        },
        {
          "id": 10241,
          "bucketName": "vs-input",
          "filePath": "/1-path/SampleVideo_1920x1080_5m.mp4",
          "status": "WAITING"
        }
      ]
    }
    

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

    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.