다음 회차 콜백

Kollus VOD는 콘텐츠의 업로드부터 재생까지 전체 워크플로우에 대해 콜백(Callback) 연동을 지원합니다.
고객사는 콜백 기능을 사용하여 주요 이벤트 발생 시 지정된 URL로 실시간 HTTP 알림을 수신할 수 있으며, 이를 통해 외부 시스템과의 데이터를 동기화하거나 업무 프로세스를 자동화할 수 있습니다.

다음 회차 콜백(Next Episode Callback)은 콘텐츠 재생 중에 플레이어가 고객사의 서버로 요청을 보내, 다음에 재생할 콘텐츠의 정보를 받아와서 연속 재생을 처리하는 기능입니다.

유의 사항

활성화 조건: 다음 회차 콜백을 사용하려면, 플레이어 호출 시 JWT 페이로드 내 next_episode 값을 true로 설정해야 합니다.
기능 간섭 주의: intro 및 outro 기능을 사용 중인 경우, 다음 회차 콜백 기능과 충돌이 발생할 수 있습니다. 따라서 이 기능들을 동시에 활성화하지 마십시오.
서버 가용성: 콜백 서버가 응답하지 않거나 응답 데이터가 형식에 맞지 않는 경우, 다음 회차 콜백 기능은 동작하지 않습니다.

콜백 설정 방법

콜백 URL은 Kollus VOD 콘솔에서 설정할 수 있습니다.
상세한 설정 위치는 콜백 설정 - 다음 회차 콜백 문서를 참고하세요.

각 설정 항목에 대한 상세 설명은 아래 콜백 설정 정보 섹션을 참고하세요.

콜백 흐름

콜백 정보 등록
- Kollus VOD 콘솔에서 채널별로 콜백 URL과 전송 항목을 설정합니다.
재생 요청 및 설정 전달
- 최종 사용자(End User)가 콘텐츠 재생을 요청할 때, 고객사 서버는 "next_episode": true가 포함된 JWT를 생성하여 VideoGateway를 호출합니다.
- VideoGateway는 플레이어에 재생 정보, 콜백 설정 값, 고객사 정의 값(uservalue0~uservalue99)을 함께 전달합니다.
다음 회차 정보 요청(POST)
- 현재 콘텐츠 재생 종료 전(설정된 시점)에 플레이어가 고객사 서버의 콜백 URL로 POST 요청을 보냅니다.
응답 데이터 생성
- 고객사 서버는 요청을 수신하면 다음 재생할 콘텐츠를 확인하고 응답 데이터를 생성합니다.
다음 회차 재생
- 플레이어는 고객사 서버로부터 수신한 JSON 데이터를 분석하여 다음 회차를 재생합니다.

콜백 설정 정보

플러그인 옵션

파라미터	타입	설명
미디어 콘텐츠 키 `{MEDIA_CONTENT_KEY}`	string	콘텐츠 식별자
사용자(서비스 회원) ID `{CLIENT_USER_ID}`	string	시청자 ID(JWT 생성 시 입력한 `client_user_id`와 동일)
인코딩 프로파일 키 `{ENCODING_PROFILE_KEY}`	string	인코딩 프로파일 식별자

ℹ️참고

영문 및 숫자를 제외한 모든 문자(한글, 한자, 일본어, 특수문자 등)는 반드시 UTF-8 URL 인코딩하여 전달해야 합니다.

다음 회차 콜백 데이터 예시

https://domain.com/callback?mck={MEDIA_CONTENT_KEY}&id={CLIENT_USER_ID}&epk={ENCODING_PROFILE_KEY}&uservalue0={USERVALUE0}

요청

전송 방식

HTTP Method: POST
Content-Type: application/x-www-form-urlencoded
Data Format: 모든 데이터는 Form Data 형식으로 전달됩니다.

응답

응답 필드

필드	타입	설명
`result`	integer	성공 여부 `0`: 실패 `1`: 성공
`next_url`	string	다음 회차 콘텐츠 재생 URL

응답 예시

{
  "result": 1,
  "next_url": "https://v.kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_KEY}"
}

ℹ️참고

JSON 문자열 전체를 평문으로 반환해야 합니다.
next_url은 반드시 /si 경로로 구성된 URL이어야 합니다.

유의 사항​

콜백 설정 방법​

콜백 흐름​

콜백 설정 정보​

플러그인 옵션​

다음 회차 콜백 데이터 예시​

요청​

전송 방식​

응답​

응답 필드​

응답 예시​