동영상 파일 업로드

업로드 토큰을 이용하여, 동영상 파일의 업로드를 실행합니다.

multipart/form data를 이용한 업로드 방식입니다. 업로드가 완료되면 원본 키와 썸네일 정보가 JSON형태로 출력됩니다.
업로드 결과는 callback 주소로 리다이렉트되며, GET {callback url}?data={JSON data} 형식으로 요청됩니다.

업로드 토큰의 버전(V1,V2,V3, V4)에 따라 요청 변수와 응답값에 차이가 있습니다.
가급적 최신 버전인 V3의 사용을 권장하며, V2 이하 버전은 더이상 지원하지 않으므로 유의바랍니다.

V4는 파일이 업로드 완료됨과 동시에 response를 내보내며, 후 처리 작업(썸네일 추출과 스토리지로 이동)은 비동기로 처리됩니다.

V4

Request URL

POST {uploadUrl}?token={token}

Request Parameters

Parameter NameTypeDescription
token (Required)String업로드 토큰 API에서 조회한 토큰 값
videofile (Required)File
(multipart/form)
업로드 할 동영상 파일 데이터
folder (Required)Integer미디어 보관함의 동영상 저장 폴더 선택
pkgInteger배포 패키지 ID
- 패키지에 편입시 인코딩 실행 및 배포 URL 발급
cidString사용자 정의 문자열 (ID) ( 최대 64 자리 )
renameString업로드 원본 파일명 변경 ( 파일 확장명은 포함하지 않습니다. )
callbackString업로드 콜백 URL
- 리다이렉트 콜백 url
- GET {Callback URL}?data={Response JSON String}
titleString동영상 제목 정보 입력
seriesString시리즈 정보 입력
authorString원작자 정보 입력
copyrightString저작권 정보 입력
rateString관람등급 정보 입력
contentString내용 정보 입력
tagString태그 정보 입력
- 여러 개 입력 시 “,”값으로 분리 (ex: tag=tag1,tag2,tag3)
orgFileDelString인코딩 이후 원본 삭제 자동 기능 ‘Y’ ( 허용 ) or ‘N’ ( default N )
- 인코딩 이후 최대 5분 소요 원본 삭제
- 업로드 시 pkg ( 패키지 ID ) 필수
etcString기타 정보 입력

Response Example

{
    uploadInfo: {
        errorInfo: {
            errorCode:“None”,
            errorMessage: “”
        },
        uploadDetail: {
            duration: 20792,
            video_height: 720,
            access_key:“UMIis5qq0ipgcqTAlzWiiQ8Bu7OLIfuThI8”,
            cid:“0909090909090”,
            video_framerate: 24,
            video_width: 1280
        }
    }
}

Response Data Value

NameTypeDescription
access_keyString원본 키 (Original Key – Video Access Key_Level 1)
durationInteger동영상 재생 시간 길이 (milli second)
video_heightInteger동영상 원본 해상도 – 세로 값
video_widthInteger동영상 원본 해상도 – 가로 값
video_framerateFloat동영상 원본 프레임 수
cidString (64)사용자 정의 문자열 (ID) ( 최대 64 자리 )

V3

Request URL

POST {uploadUrl}?token={token}

Request Parameters

Parameter NameTypeDescription
token (Required)String업로드 토큰 API에서 조회한 토큰 값
videofile (Required)File
(multipart/form)
업로드 할 동영상 파일 데이터
folder (Required)Integer미디어 보관함의 동영상 저장 폴더 선택
pkgInteger배포 패키지 ID
- 패키지에 편입시 인코딩 실행 및 배포 URL 발급
cidString사용자 정의 문자열 (ID) ( 최대 64 자리 )
renameString업로드 원본 파일명 변경 ( 파일 확장명은 포함하지 않습니다. )
callbackString업로드 콜백 URL
- 리다이렉트 콜백 url
- GET {Callback URL}?data={Response JSON String}
titleString동영상 제목 정보 입력
seriesString시리즈 정보 입력
authorString원작자 정보 입력
copyrightString저작권 정보 입력
rateString관람등급 정보 입력
contentString내용 정보 입력
tagString태그 정보 입력
- 여러 개 입력 시 “,”값으로 분리 (ex: tag=tag1,tag2,tag3)
orgFileDelString인코딩 이후 원본 삭제 자동 기능 ‘Y’ ( 허용 ) or ‘N’ ( default N )
- 인코딩 이후 최대 5분 소요 원본 삭제
- 업로드 시 pkg ( 패키지 ID ) 필수
etcString기타 정보 입력

Response Example

{
    uploadInfo: {
        errorInfo: {
            errorCode:“None”,
            errorMessage: “”
        },
        uploadDetail: {
            duration: 20792,
            video_height: 720,
            access_key:“UMIis5qq0ipgcqTAlzWiiQ8Bu7OLIfuThI8”,
            cid: “0909090909090”,
            video_framerate: 24,
            video_width: 1280
        },
        thumbnails: [{
                seq: 1,
                playtime: 1,
                url: “http://timg.wecandeo.com/thumb/11/20130207/12/5357_2c046_00000.jpg”
            },
            {
                seq: 2,
                playtime: 4,
                url: “http://timg.wecandeo.com/thumb/11/20130207/12/5357_2c046_00001.jpg”
            },
            {
                seq: 3,
                playtime: 7,
                url: “http://timg.wecandeo.com/thumb/11/20130207/12/5358_dcf96_00000.jpg”
            },
            {
                seq: 4,
                playtime: 10,
                url: “http://timg.wecandeo.com/thumb/11/20130207/12/5358_dcf96_00001.jpg”
            }
        ]
    }
}

Response Data Value

NameTypeDescription
access_keyString원본 키 (Original Key – Video Access Key_Level 1)
durationInteger동영상 재생 시간 길이 (milli second)
video_heightInteger동영상 원본 해상도 – 세로 값
video_widthInteger동영상 원본 해상도 – 가로 값
video_framerateFloat동영상 원본 프레임 수
cidString (64)사용자 정의 문자열 (ID) ( 최대 64 자리 )