다음 회차 콜백

다음 회차 콜백은 콘텐츠 재생 중 다음 재생할 콘텐츠 정보를 실시간으로 받아와 연속 재생을 구현하는 기능입니다. 플레이어는 현재 영상이 끝나기 전 고객사 서버에 다음 영상의 URL을 요청하여 재생을 이어갑니다.

유의 사항

활성화 조건: 재생용 JWT 생성 시 "next_episode": true 파라미터를 반드시 포함합니다. 마지막 회차의 경우 이 값을 false로 설정하여 기능을 비활성화합니다.
기능 간섭 주의: intro 및 outro 기능과 동시에 사용할 수 없습니다.
서버 가용성: 콜백 서버 응답 지연이나 데이터 규격 불일치 시 기능은 동작하지 않습니다.

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

콜백 요청 시 고객사 서버로 함께 전달될 파라미터 항목입니다.

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

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

ℹ️참고

한글, 특수문자, 공백이 포함된 경우, 반드시 해당 값을 UTF-8 URL 인코딩(URL Encoding) 처리하여 전달해야 합니다.

고객사 서버는 다음 재생 정보를 암호화되지 않은 Plain JSON 형식으로 반환해야 합니다.

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

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

⚠️주의