엠군 채널에 동영상 파일 업로드를 실행합니다.

API를 통한 동영상 업로드 과정은 일반적으로 다음의 단계를 거치게 됩니다. [시작 → 동영상 업로드 API 실행 → Response {ulpoad_status_url} → 동영상 업로드 상태 조회 API → Response {status=”COMPLETE”, encode_status_url} → 동영상 인코딩 상태 조회 API → Response {status=”SERVICE”} → 완료] 따라서, 각 단계에 필요한 값이 발급될 때까지는 이전 단계의 API를 반복 재요청해야 합니다.

업로드 실행 파라미터 중 필수항목 이외의 선택항목을 미입력시에는 지정된 기본 값으로 자동 입력됩니다.

 

Request URL 

http://openapi.mgoon.com/api/upload/uploadStart.json

 

Request Parameters

Parameter Name Type Description
apiKey (필수) String API 키
videofile (필수) File (multipart/form) 업로드 할 동영상 파일 데이터
– 파일 용량은 2GB 이하로 제한
vcategory (필수) Integer 엠군 동영상 카테고리 분류 선택
– 1: 연예/스타
– 2: 음악/댄스
– 3: 영화/방송
– 4: 코믹/유머
– 5: 스포츠
– 6: 게임
– 7: 뉴스/이슈
– 8: 교양/정보
– 9: 일상/생활
– 10: 브랜드/스타일
– 99: 성인
vtitle (필수) String 동영상 제목 정보 입력
vdesc String 동영상 내용 정보 입력
vaccess Integer 동영상 공개 설정
– 1: 전체공개 (default)
– 2: 비공개
– 3: 구독자 공개
– 4: 엠군 외 공개
vplaylist Integer 채널 플레이리스트 선택
– 플레이리스트 조회 API를 통해 조회
callbackUrl String 업로드 콜백 URL
– 리다이렉트 콜백 URL
– GET {Callback URL}?data={Response JSON String}

 

Response Example

{
“data”:{
“upload_status_url”: <업로드 상태 조회 url>
“video_id”: <동영상 ID>
},
“errorInfo”:{
“message”:””,”code”:”None”
}
}

 

Response Data Value

Name Type Description
upload_status_url String 업로드 상태 조회 URL
– http://openapi.mgoon.com/api/upload/uploadStatus.json?uKey={업로드 정보 KEY}
– 해당 URL로 업로드의 progress 를 체크 할 수 있음
video_id Long 업로드 한 동영상 ID