본문으로 건너뛰기

Kollus VOD API v1/v2 서비스 종료 및 v3 마이그레이션

2026년 7월 15일
적용 대상 플랜 안내

본 공지사항에서 안내하는 VOD API 서비스(v1/v2 종료 및 v3 마이그레이션)는 Enterprise 플랜을 이용 중인 워크스페이스(고객사)에 한정하여 적용됩니다.

기존 제공 중이던 Kollus VOD API v1 및 v2 서비스를 2026년 12월 31일부로 공식 종료합니다. 현재 VOD API v1/v2를 사용 중인 고객사에서는 향후 서비스 중단 등의 문제가 발생하지 않도록 반드시 기한 내에 v3로 마이그레이션(전환)을 완료해 주시기 바랍니다.

사용 중인 API 버전 확인 방법​

고객사 애플리케이션 또는 시스템 환경에서 현재 호출하고 있는 API 호스트 도메인이 아래와 같다면 마이그레이션 대상에 해당합니다.

  • VOD API v1 도메인 (종료 대상): https://api.kr.kollus.com
  • VOD API v2 도메인 (종료 대상): https://api-vod-kr.kollus.com/api/v0

마이그레이션 가이드​

VOD API v3의 기본 도메인 및 기능 명세는 아래 링크를 통해 확인할 수 있습니다.

마이그레이션 필수 조치 사항​

안정적인 서비스 전환을 위해 다음 항목들을 중심으로 시스템을 점검하고 업데이트해 주시기 바랍니다.

  1. 도메인 및 엔드포인트 변경: 기존 VOD API v1/v2 호출 도메인을 v3 도메인으로 교체하고, URL 경로(Path)를 v3 규격에 맞게 수정합니다.
  2. 인증 및 파라미터 점검: access_token 공통 인증 방식을 적용하고, 각 API별 요청 파라미터 및 응답 데이터 구조의 변경사항을 코드에 반영합니다.
  3. 핵심 기능 테스트: 업로드, 재생, 메타데이터 연동 등 주요 비즈니스 로직이 v3 환경에서 정상적으로 동작하는지 확인합니다.
  4. 사전 검증 및 배포: 상용 환경에 반영하기 전, 충분한 사전 테스트(QA)를 진행하여 서비스 장애를 예방할 것을 적극 권장합니다.

마이그레이션 일정 및 기술 지원​

  • 권장 완료 기한: 원활한 기술 지원과 안정적인 서비스 운영을 위해 2026년 11월 30일 전까지 마이그레이션 작업을 완료해 주시기 바랍니다.
  • 기술 지원 문의: 마이그레이션 과정에서 기술적인 문의 사항이나 연동 지원이 필요하신 경우, Kollus 기술 지원팀(tech_support@kollus.com)으로 문의해 주세요.
  • 기존 버전 사용 안내: VOD API v1/v2는 2026년 12월 31일까지 정상적으로 사용 가능합니다.