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를 이용하시기 바랍니다.
| Name | Level | Description |
|---|---|---|
| 원본 키 (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’으로 출력됩니다.
| Name | Type | Description |
|---|---|---|
| errorCode | String | - None (없음) - InternalServerError (서버 오류) - AuthenticationError (인증 오류) - BadRequest (잘못된 요청) - ResourceNotFound (정보를 찾을수 없음) - VideoAborted (배포 중지된 비디오) - ExpiredAccount (만료된 계정) - OverTraffic (트래픽 초과) - OverStorage (용량 초과) - NotSupportAccess (지원 되지 않는 연결) |