---
title: "카테고리 콜백 사용"
slug: "vodstation-category-callback"
updated: 2026-10-22T10:47:44Z
published: 2026-10-22T10:47:44Z
canonical: "api-gov.ncloud-docs.com/vodstation-category-callback"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.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 요청 시 `notification`에 콜백 URL을 입력하여 콜백을 설정해 주십시오.

- [카테고리 생성](/docs/vodstation-category-create)
- [카테고리 파일 추가](/docs/vodstation-category-addfiles)

          참고

          

콜백 메시지는 `encodingOptionId`마다 개별 발송됩니다. 예를 들어, 카테고리에 3개의 인코딩 옵션이 설정되어 있고 입력 파일에 대해 인코딩 상태가 변경되었다면 각 인코딩 옵션별로 상태 변경에 대한 콜백을 발송합니다.

## 콜백 메시지

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `categoryId` | Integer | - | 카테고리 아이디 |
| `categoryName` | String | - | 카테고리 이름 |
| `fileId` | Integer | - | 입력 파일 아이디 - [카테고리 파일 추가](/docs/vodstation-category-addfiles) 참조 - 응답 바디의 `id`(파일 인코딩 작업 아이디) |
| `filePath` | String | - | 파일명을 포함한 입력 파일의 버킷 상세 경로 - `status`가 `WAITING`(대기)인 경우, 빈 문자열로 전송 |
| `encodingOptionId` | Integer | - | 인코딩 옵션 아이디 |
| `outputType` | String | - | 출력 타입 |
| `link` | String | - | 파일명을 포함한 출력 파일의 HTTP URL 경로 - `status`가 `COMPLETE`(완료)인 경우, 표시 |
| `status` | String | - | 파일 인코딩 상태 - `COMPLETE` \| `WAITING` \| `RUNNING` \| `FAILURE` - `COMPLETE`: 완료 - `WAITING`: 대기 - `RUNNING`: 진행 중 - `FAILURE`: 실패 |

## 콜백 메시지 예시

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

```
// 작업 대기 (WAITING)
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "",
  "encodingOptionId": 2,
  "outputType": "AVC_SD_1Pass_30fps_1",
  "status": "WAITING"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "",
  "encodingOptionId": 1,
  "outputType": "AVC_SD_1Pass_30fps",
  "status": "WAITING"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "",
  "encodingOptionId": 3,
  "outputType": "AVC_HD_1Pass_30fps",
  "status": "WAITING"
}

// 작업 진행 중 (RUNNING)
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_HD_1Pass_30fps.mp4",
  "encodingOptionId": 3,
  "outputType": "AVC_HD_1Pass_30fps",
  "status": "RUNNING"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_SD_1Pass_30fps.mp4",
  "encodingOptionId": 1,
  "outputType": "AVC_SD_1Pass_30fps",
  "status": "RUNNING"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_SD_1Pass_30fps_1.mp4",
  "encodingOptionId": 2,
  "outputType": "AVC_SD_1Pass_30fps_1",
  "status": "RUNNING"
}

// 작업 완료 (COMPLETE)
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_SD_1Pass_30fps.mp4",
  "encodingOptionId": 1,
  "outputType": "AVC_SD_1Pass_30fps",
  "link": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_SD_1Pass_30fps.mp4",
  "status": "COMPLETE"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_SD_1Pass_30fps_1.mp4",
  "encodingOptionId": 2,
  "outputType": "AVC_SD_1Pass_30fps_1",
  "link": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_SD_1Pass_30fps_1.mp4",
  "status": "COMPLETE"
}
{
  "categoryId": 13814,
  "categoryName": "VOD-Callback",
  "fileId": 1163694,
  "filePath": "/VOD-Callback/VODStation_AVC_HD_1Pass_30fps.mp4",
  "encodingOptionId": 3,
  "outputType": "AVC_HD_1Pass_30fps",
  "link": "https://kr.object.ncloudstorage.com/station-000/VOD-Callback/VODStation_AVC_HD_1Pass_30fps.mp4",       
  "status": "COMPLETE"
}
```