엠군 채널링 API를 이용하여 웹사이트 또는 어플리케이션에 엠군의 동영상 콘텐츠를 서비스할 수 있습니다. 엠군의 카테고리 분류, 검색, 채널별 동영상, 추천 큐레이션 동영상 목록 등을 이용할 수 있습니다. 이 API를 이용하면 제휴 협약에 따른 광고 수익 분배도 자동으로 반영됩니다.

 

API 키
채널링 API를 사용하기 위해서는 API 키가 필요합니다. API 키는 채널링 매체별로 부여되는 고유한 값이며, 관리자에게 요청하여 발급받을 수 있습니다. * 업로드 API에 이용하는 계정별 API 키와 호환되지 않습니다.[요청하기]

 

에러코드
채널링 API에서 공통적으로 출력되는 에러코드는 다음과 같습니다. 에러 없이 정상 처리된 경우 ‘NONE’으로 출력됩니다.

Name Type Description
errorCode String 기본 에러 코드
– NONE: 없음, 정상
– FAIL: 실패
– INTERRUPT: 관리자 중단 처리된 동영상
– DELETED: 삭제된 동영상
– VIDEO_NOT_FOUND: 존재하지 않는 동영상
errorCode String 채널링 API 에러 코드
– INVALID_APIKEY: 유효하지 않은 채널링 API 키 입니다.
– ALLOW_ADULT: 성인 컨텐츠 허용 채널링 입니다.
– DISALLOW_ADULT: 성인 컨텐츠가 허용되지 않는 채널링입니다.
– CURATION_NOT_EXIST: 큐레이션이 존재하지 않습니다.
– CURATION_API_CLOSED: 채널링 API에서 사용하도록 공개되지 않은 큐레이션입니다.
– CURATION_OPEN_ALL: 성인을 제외한 전체 공개 큐레이션입니다.
– CURATION_OPEN_ALLOW_ADULT: 성인컨텐츠가 허용된 채널링에만 공개된 큐레이션입니다.
– CHANNEL_NOT_EXIST: 채널이 존재하지 않습니다.
– CHANNEL_API_CLOSED: 채널링 API에서 사용하도록 공개되지 않은 채널입니다.

 
동영상 상세 정보
채널링 API에서 공통적으로 출력되는 동영상 상세 정보는 다음과 같습니다.

Name Type Description
id Long 동영상 ID
upload_time String 동영상을 업로드한 날짜와 시간
duration Integer 동영상의 재생 시간 (ms)
videoUrl String 동영상 재생 URL
title String 동영상 제목
decs String 동영상 내용
width Integer 동영상 원본 가로 해상도 (px)
height Integer 동영상 원본 세로 해상도 (px)
thumbnail String 대표로 지정된 동영상 썸네일 이미지 URL
thumbnails String 동영상에서 추출된 썸네일 이미지의 정보

 

동영상의 Embed
채널링 API를 이용하는 경우 동영상의 Embed는 반드시 iframe 형식을 이용해야 합니다.
API 요청을 통해 응답받은 동영상 상세 정보 중 ‘videoUrl’을 iframe 형태로 Embed하면 됩니다.
동영상의 자동 시작, 볼륨 조정, 디자인 변경 등은 플레이어 Parameters 문서를 참고하세요.

< iframe src=”http://www.mgoon.com/play/partner/test0307/6288487″ width=”640″ height=”360″ frameborder=”0″ scrolling=”no” allowfullscreen>< /iframe>

* 예시 코드를 복사할 경우 태그 공백을 지우고 사용하세요.

Embed Example