본문으로 건너뛰기

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

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

VOD API 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@catenoid.net)으로 문의해 주세요.
  • 기존 버전 사용 안내: VOD API v1, v2는 2026년 12월 31일까지 정상적으로 사용 가능합니다.