개요

VIDEOPACK API를 이용하여 웹사이트 또는 어플리케이션에 미디어 업로드 및 관리, 목록 조회, 상세 정보 조회 등의 기능을 탑재할 수 있습니다. API 목록은 VIDEOPACK의 관리자 메뉴 구성과는 일부 다르게, 미디어 아이템과 기능 실행 행동에 따라 분류되어 있습니다.

API Key (key)

VIDEO PACK – API를 사용하기 위해서는 계정별로 발행되는 고유의 API Key가 필요합니다. API Key는 VIDEO PACK 관리자 화면의 [계정 관리 > 개발자 API] 메뉴에서 얻을 수 있습니다.

Access Key (access_key)

동영상 Access Key는 3개의 Level로 구성되어있으며, 각 Level 별로 성격과 용도가 다릅니다. 각 API의 Request Parameter와 Response Value 값의 설명을 참조하여 조건에 맞는 Level의 Access Key를 이용하시기 바랍니다.

NameLevelDescription
원본 키
(Original Key)
Access Key_Level 1동영상 업로드 시 발급되는 원본의 키 값
– 미디어 보관함 > 동영상 > 동영상 상세 정보의 Access Key 값
동영상 키
(Video Key)
Access Key_Level 2배포 패키지에 편입 시 발급되는 배포용 동영상 키 값
– 배포 패키지 > 동영상 > 동영상 상세 정보의 Video Key 값
인코딩 파일 키
(File Key)
Access Key_Level 3배포 패키지에서 인코딩이 완료된 파일 키 값
– 배포 패키지 > 동영상 > 동영상 상세 정보 > 인코딩 파일 > File Key 값

동영상의 URL

동영상 URL은 Video URL과 Play URL이 있으며, 각각의 URL 형식 + Access_Key의 조합으로 구성됩니다. Access_Key는 Video Key(Level2)와 File Key(Level3)를 사용할 수 있으며, Original Key(Level1)은 사용할 수 없습니다.

Video URL은 파일을 직접 호출하는 주소입니다.

https://api.wecandeo.com/video?k={access_key_Level2 or Level3}
https://api.wecandeo.com/video/default/{access_key_Level2 or Level3}

Play URL은 WECANDEO의 내장 플레이어를 호출하는 Web Page 주소입니다.

https://play.wecandeo.com/v/?key={access_key_Level2 or Level3}

에러코드

VIDEO PACK – API에서 공통적으로 출력되는 에러코드는 다음과 같습니다.
에러가 없는 경우는 공통적으로 ‘none’으로 출력됩니다.

NameTypeDescription
errorCodeString- None (없음)
- InternalServerError (서버 오류)
- AuthenticationError (인증 오류)
- BadRequest (잘못된 요청)
- ResourceNotFound (정보를 찾을수 없음)
- VideoAborted (배포 중지된 비디오)
- ExpiredAccount (만료된 계정)
- OverTraffic (트래픽 초과)
- OverStorage (용량 초과)
- NotSupportAccess (지원 되지 않는 연결)