WECANDEO의 각 상품별 OPEN API 사용과 제한에 대한 안내입니다.
공통 유의사항
사용하는 API의 버전은 상품의 버전과 동일해야 합니다.
e.g., VIDEOPACK V4 → API v3.0 사용(❌), API v4.0 사용(⭕)
과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.
비정상적인 사용 패턴이 발견되는 경우 API 이용이 제한될 수 있습니다.
현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트 될 수 있습니다.
VIDEOPACK API
지원 프로토콜
모든 데이터는 HTTPS 기반으로 데이터 송/수신을 처리합니다.
Header 설정
[x-api-key] 헤더에 제공되는 API KEY를 설정하여 호출해야 합니다.
사용 제한 정책
- 요청 횟수 제한
단일 계정에서 1초에 요청할 수 있는 횟수(requests per second)는 10회 입니다.
단일 계정에서 1일에 요청할 수 있는 횟수(requests per day)는 아래와 같습니다.
그룹 | API | 요청 수 (requests per day) |
---|---|---|
업로드 | 그룹 내 각 API | 제한없음 |
동영상 데이터 조회 ✳ | 그룹 내 각 API | 제한없음 |
동영상 데이터 변경 | 그룹 내 각 API | 제한없음 |
배포 패키지 | 그룹 내 각 API | 제한없음 |
미디어 보관함 | 그룹 내 각 API | 제한없음 |
일일 요청 횟수는 UTC 기준 00:00:00에 초기화됩니다.
✳ 동영상 데이터 조회의 각 API 응답은 실시간 데이터를 반영하지 않습니다.
적용 및 변경사항이 응답 데이터에 포함되기까지는 요청시점에 따라 최대 1분이 걸릴 수 있습니다.
- 사용량 제한
요청에 대해 반환될 수 있는 항목의 최대 수(pageSize) 제한은 없습니다.
- 동시 요청 제한
단일 계정에서 한 번에 하나의 요청을 처리합니다.
여러 요청이 연속적으로 실행된 경우, 이전 요청이 완료될 때까지 다음 요청은 대기하고 요청이 순차적으로 처리됩니다.
VIDEOPACK STATISTICS
지원 프로토콜
모든 데이터는 SSL(HTTPS) 기반으로 데이터 송/수신을 처리합니다.
HTTP프로토콜 GET
Header 설정
[x-api-key] 헤더에 제공되는 API KEY를 설정하여 호출해야 합니다.
사용 제한 정책
- 요청 횟수 제한
단일 계정에서 1초에 요청할 수 있는 횟수(requests per second)는 10회 입니다.
단일 계정에서 1일에 요청할 수 있는 횟수(requests per day)는 아래와 같습니다.
그룹 | API | 요청 수 (requests per day) |
---|---|---|
재생 통계 | 그룹 내 각 API | 제한없음 |
사용량 통계 | 그룹 내 각 API | 제한없음 |
일일 요청 횟수는 UTC 기준 00:00:00에 초기화됩니다.
- 사용량 제한
요청에 대해 반환될 수 있는 항목의 최대 수(pageSize)는 999건 입니다.
최대 반환 수를 초과한 경우 데이터의 범위를 줄여서 요청하셔야 합니다.
- 동시 요청 제한
단일 계정에서 한 번에 하나의 요청을 처리합니다.
여러 요청이 연속적으로 실행된 경우, 이전 요청이 완료될 때까지 다음 요청은 대기하고 요청이 순차적으로 처리됩니다.
- 검색 기간의 제한
요청 시 반드시 검색 기간을 포함하여야 하며, 검색 기간은 시작일(sdate) ~ 종료일(edate)의 기간을 최장 1년 이내로 설정하여 요청이 가능합니다.
✳ VIDEOPACK STATISTICS의 각 API 응답은 실시간 데이터를 반영하지 않습니다.
현재 데이터가 응답 데이터에 포함되기까지는 요청시점에 따라 최대 2시간이 걸릴 수 있습니다.