채널 콜백 사용

Classic/VPC 환경에서 이용 가능합니다.

VOD Station은 채널 상태 확인을 위한 콜백(Callback) 기능을 사용할 수 있습니다. 콜백 사용 시 VOD Station에서 채널 상태 변경 이벤트가 발생할 때마다 설정된 notificationUrl로 콜백 메시지가 자동으로 전송됩니다. 다음 API 요청 시 notificationUrl에 콜백 URL을 입력하여 콜백을 설정해 주십시오.

채널 생성

콜백 메시지

콜백 메시지에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
id	String	-	채널 아이디
name	String	-	채널 이름
channelStatus	String	-	채널 상태 `READY` \| `STARTING` \| `STOPPING` \| `STOPPED` \| `FORCE_STOPPING` \| `FORCE_STOPPED` \| `TERMINATING` \| `TERMINATED` \| `FORCE_TERMINATING` \| `FORCE_TERMINATED` `READY`: 운영 중 `STARTING`: 시작 중 `STOPPING`: 정지 중 `STOPPED`: 정지 완료 `TERMINATING`: 삭제 중 `TERMINATED`: 삭제 완료 `FORCE_STOPPING`: 강제 정지 중 `FORCE_STOPPED`: 강제 정지 완료 `FORCE_TERMINATING`: 강제 삭제 중 `FORCE_TERMINATED`: 강제 삭제 완료

콜백 메시지 예시

콜백 메시지 예시는 다음과 같습니다.

// 채널 운영중(READY)
{
  "id": "vs-20260414133728-*******",
  "name": “ch-callback”,
  "channelStatus": "READY"
}

// 채널 정지(STOPPED)
{
  "id": "vs-20260414133728-*******",
  "name": "ch-callback",
  "channelStatus": "STOPPED"
}

// 채널 삭제(TERMINATED)
{
  "id": "vs-20260414133728-*******",
  "name": "ch-callback",
  "channelStatus": "TERMINATED"
}