업로드 토큰을 이용하여, 동영상 파일의 업로드를 실행합니다.
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 Name | Type | Description |
|---|---|---|
| token (Required) | String | 업로드 토큰 API에서 조회한 토큰 값 |
| videofile (Required) | File (multipart/form) | 업로드 할 동영상 파일 데이터 |
| folder (Required) | Integer | 미디어 보관함의 동영상 저장 폴더 선택 |
| pkg | Integer | 배포 패키지 ID - 패키지에 편입시 인코딩 실행 및 배포 URL 발급 |
| cid | String | 사용자 정의 문자열 (ID) ( 최대 64 자리 ) |
| rename | String | 업로드 원본 파일명 변경 ( 파일 확장명은 포함하지 않습니다. ) |
| 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) |
| orgFileDel | String | 인코딩 이후 원본 삭제 자동 기능 ‘Y’ ( 허용 ) or ‘N’ ( default N ) - 인코딩 이후 최대 5분 소요 원본 삭제 - 업로드 시 pkg ( 패키지 ID ) 필수 |
| 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) ( 최대 64 자리 ) |
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) ( 최대 64 자리 ) |
| rename | String | 업로드 원본 파일명 변경 ( 파일 확장명은 포함하지 않습니다. ) |
| 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) |
| orgFileDel | String | 인코딩 이후 원본 삭제 자동 기능 ‘Y’ ( 허용 ) or ‘N’ ( default N ) - 인코딩 이후 최대 5분 소요 원본 삭제 - 업로드 시 pkg ( 패키지 ID ) 필수 |
| 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) ( 최대 64 자리 ) |