MENU
      카테고리 파일 추가

        카테고리 파일 추가


        기사 요약

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

        요청

        PUT https://vodstation.apigw.ntruss.com/api/v2/category/{categoryId}/add-files
        HTTP

        요청 헤더

        헤더명설명
        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://vodstation.apigw.ntruss.com/api/v2/category/10095/add-files
        
        PUT /api/v2/category/10095/add-files
        HOST: vodstation.apigw.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

        응답 예시

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