API 사용 및 제한

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시간이 걸릴 수 있습니다.