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

API Key

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

❗️
Header 설정
VIDEOPACK API를 사용하여 요청할 때 API Key를 [x-api-key] 헤더에 설정하여 호출해야 합니다.

동영상 Key

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

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

동영상의 URL

동영상 URL은 Video URL과 Play URL이 있으며, 각각의 URL 형식 + Video Key(또는 Video File Key)의 조합으로 구성됩니다. Access Key는 원본 동영상의 키로 Video URL 또는 Play URL에 사용할 수 없습니다.

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

✳ Domain은 VIDEOPACK 생성 시 발급 받은 도메인입니다.

- VIDEO URL PARAM TYPE
videoUrl PARAM :: https://{DOMAIN}/video/file?key={videoKey}

- VIDEO URL PATH TYPE
videoUrl PATH :: https://{DOMAIN}/video/file/default/{videoKey}

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

https://{DOMAIN}/play/video/v/?key={videoKey}

에러코드

VIDEOPACK API에서 공통적으로 출력되는 에러코드는 다음과 같습니다.

Name	Type	Description
Http Response Code	Integer	Http 상태 코드 표시
message	String	각 응답 결과에 대한 상세 메시지 표시