---
title: "채널 콜백 사용"
slug: "vodstation-channel-callback"
updated: 2026-09-17T09:16:48Z
published: 2026-09-17T09:16:48Z
canonical: "api.ncloud-docs.com/vodstation-channel-callback"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 채널 콜백 사용

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

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

- [채널 생성](/docs/vodstation-channel-create)

## 콜백 메시지

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| 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"
}
```