엠군 채널에 업로드한 동영상 목록과 동영상 상세 정보를 조회합니다.

채널 내 전체 동영상 목록을 조회하거나 플레이리스트로 동영상 목록을 조회할 수 있습니다. 조회 결과 목록에는 공개 설정이 ‘전체공개’이거나 ‘엠군외공개’인 동영상이 포함되며, ‘비공개’ 또는 ‘구독자공개’인 동영상은 포함되지 않습니다. 공개 설정과 무관하게, 관리자가 게시물 운영정책에 따라 ‘관리자 중단’처리한 동영상도 포함되지 않습니다. 목록의 동영상 정보 내용은 동영상 상세 정보 조회 API를 통한 응답값과 동일합니다.

 

Request URL 

http://openapi.mgoon.com/api/video/videos.json

 

Request Parameters

Parameter Name Type Description
apiKey (필수) String API 키
playlist_id Long 특정 플레이리스트의 동영상 목록 조회시 입력
– 미입력시 전체 동영상 목록 출력
page Integer 동영상 목록 페이지 번호 (default: 1)
perPage Integer 페이지당 출력할 목록 수량 (default: 12)
sort Integer 동영상 목록의 정렬 타입
– 1: 최신순 (default)
– 2: 제목순
– 3: 재생순
order Integer 동영상 목록의 정렬 순서
– 1: desc 내림차순 (default)
– 2: asc 오름차순

 

Response Example

{
data: {
page: 1,
totalCount: 243,
videos: [
{
id:12345,
upload_time: “2015-01-15 18:36:41”,
duration: 3548231,
title: “업로드 테스트”,
thumbnail: “http://www.mgoon.com/thumb/385/20150115/18/4047_706b9_00001.jpg”,
desc: “”,
videoUrl: “http://www.mgoon.com/play/view/12345”,
width: 1280,
height: 720,
thumbnails: [생략]
},
{
id:12345,
upload_time: “2015-01-15 18:36:41”,
duration: 3548231,
title: “업로드 테스트”,
thumbnail: “http://www.mgoon.com/thumb/385/20150115/18/4047_706b9_00001.jpg”,
desc: “”,
videoUrl: “http://www.mgoon.com/play/view/12345”,
width: 1280,
height: 720,
thumbnails: [생략]
},
],
perPage: 12
},
errorInfo: {
message: “”,
code: “NONE”
}
}
}

 

Response Data Value

Name Type Description
page Integer 페이지 번호
perPage Integer 페이지당 출력할 목록 수량
totalCount Integer 조회된 동영상 목록의 전체 수량
videos String 동영상 목록 & 동영상 상세 정보
– 동영상 상세 정보 내용은 동영상 상세 정보 조회 API 내용과 동일