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

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

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

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

 

V4

Request URL 

POST {uploadUrl}?token={token}

Request Parameters

Parameter Name Type Description
token (Required) String 업로드 토큰 API에서 조회한 토큰 값
videofile (Required) File (multipart/form) 업로드 할 동영상 파일 데이터
folder (Required) Integer 미디어 보관함의 동영상 저장 폴더 선택
pkg Integer 배포 패키지 ID
– 패키지에 편입시 인코딩 실행 및 배포 URL 발급
cid String 사용자 정의 문자열 (ID)
drm_cid String DRM용 사용자 정의 문자열
callback String 업로드 콜백 URL
– 리다이렉트 콜백 url
– GET {Callback URL}?data={Response JSON String}
title String 동영상 제목 정보 입력
series String 시리즈 정보 입력
author String 원작자 정보 입력
copyright String 저작권 정보 입력
rate String 관람등급 정보 입력
content String 내용 정보 입력
tag String 태그 정보 입력
– 여러 개 입력 시 “,”값으로 분리 (ex: tag=tag1,tag2,tag3)
etc String 기타 정보 입력

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

Name Type Description
access_key String 원본 키 (Original Key – Video Access Key_Level 1)
duration Integer 동영상 재생 시간 길이 (milli second)
video_height Integer 동영상 원본 해상도 – 세로 값
video_width Integer 동영상 원본 해상도 – 가로 값
video_framerate Float 동영상 원본 프레임 수
cid String (64) 사용자 정의 문자열 (ID)

 

 

V3

Request URL 

POST {uploadUrl}?token={token}

Request Parameters

Parameter Name Type Description
token (Required) String 업로드 토큰 API에서 조회한 토큰 값
videofile (Required) File (multipart/form) 업로드 할 동영상 파일 데이터
folder (Required) Integer 미디어 보관함의 동영상 저장 폴더 선택
pkg Integer 배포 패키지 ID
– 패키지에 편입시 인코딩 실행 및 배포 URL 발급
cid String 사용자 정의 문자열 (ID)
drm_cid String DRM용 사용자 정의 문자열
callback String 업로드 콜백 URL
– 리다이렉트 콜백 url
– GET {Callback URL}?data={Response JSON String}
title String 동영상 제목 정보 입력
series String 시리즈 정보 입력
author String 원작자 정보 입력
copyright String 저작권 정보 입력
rate String 관람등급 정보 입력
content String 내용 정보 입력
tag String 태그 정보 입력
– 여러 개 입력 시 “,”값으로 분리 (ex: tag=tag1,tag2,tag3)
etc String 기타 정보 입력

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

Name Type Description
access_key String 원본 키 (Original Key – Video Access Key_Level 1)
duration Integer 동영상 재생 시간 길이 (milli second)
video_height Integer 동영상 원본 해상도 – 세로 값
video_width Integer 동영상 원본 해상도 – 가로 값
video_framerate Float 동영상 원본 프레임 수
cid String (64) 사용자 정의 문자열 (ID)

 

V2

Request URL 

POST {uploadUrl}?token={token}

Request Parameters

Parameter Name Type Description
token (Required) String (GET) 업로드 토큰 API에서 조회한 토큰 값
videofile (Required) File (multipart/form) 업로드 할 동영상 파일 데이터
folder (Required) Integer(multipart/form) 미디어 보관함의 동영상 저장 폴더 선택
cid String (multipart/form) 사용자 정의 문자열 (ID)
drm_cid String DRM용 사용자 정의 문자열
callback String (multipart/form) 업로드 콜백 URL
– 리다이렉트 콜백 url
– GET {Callback URL}?data={Response JSON String}

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

Name Type Description
access_key String 원본 키 (Original Key – Video Access Key_Level 1)
duration Integer 동영상 재생 시간 길이 (milli second)
video_height Integer 동영상 원본 해상도 – 세로 값
video_width Integer 동영상 원본 해상도 – 가로 값
video_framerate Float 동영상 원본 프레임 수
cid String (64) 사용자 정의 문자열 (ID)