# 콜백

{% hint style="info" icon="bullhorn" %}

## **새로운 Kollus Docs 사이트에서 이 문서의 최신 버전을 확인하세요!**

본 문서는 **구버전**이며, 더 정확하고 최신화된 정보는 아래 신규 경로에서 확인하실 수 있습니다.

* **신규 문서**: [서비스 계정 > 콜백(Callback) 설정](https://docs.kollus.com/service-guide/vod/account/service-account/#%EC%BD%9C%EB%B0%B1callback-%EC%84%A4%EC%A0%95)
* **게시 중단 안내**: 본 문서는 **2026년 6월 30일**까지만 제공됩니다.
  {% endhint %}

이 페이지에서는 Kollus VOD 콘솔의 서비스 계정 메뉴에서 제공하고 있는 콜백에 대해 안내합니다.

> ### **콜백** <a href="#id-.1" id="id-.1"></a>
>
> 콜백(callback) URL은 Kollus VOD 콘솔에서 작업이 완료되었음을 알리기 위해 사용되는 URL입니다. 이 URL은 고객의 서버 또는 웹 애플리케이션에 연결되어 있으며, Kollus VOD 콘솔에서 작업 완료와 관련된 정보를 전송합니다.

### **콜백** <a href="#id-.2" id="id-.2"></a>

Kollus VOD 콘솔에서는 콜백(callback) URL을 **설정 > 콜백** 메뉴에서 등록할 수 있으며, 작업 완료와 관련된 정보는 HTTP POST 방식으로 전송됩니다. 콜백 URL은 업로드, 트랜스코딩, 콘텐츠 업데이트 등 작업의 진행 상황과 결과를 전달하기 때문에, 적절한 보안 조치를 취하고 안정적인 서버나 웹 애플리케이션을 유지하는 것이 중요합니다. 이러한 콜백 알림을 이용하여 작업의 진행 상황과 결과를 실시간으로 파악할 수 있습니다. 이를 활용하여 고객은 더욱 효율적이고 원활한 서비스를 제공할 수 있습니다.

<figure><img src="https://92012944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F07xE4g9511BtbCTnY4D4%2Fuploads%2F7C6j4KNUT5RCgwVuEWEt%2Fimage.png?alt=media&#x26;token=d857493b-182f-445c-9f48-433267a5328e" alt=""><figcaption><p>콜백</p></figcaption></figure>

<table><thead><tr><th width="225.111083984375">항목</th><th>설명</th></tr></thead><tbody><tr><td>업로드 콜백 URL</td><td>업로드된 파일을 구분하는 고유한 키인 업로드 파일 키를 이용하여 업로드 완료 시 콜백 알림을 해당 URL에 전송합니다.</td></tr><tr><td>트랜스코딩 콜백 URL</td><td>트랜스코딩 작업의 대상이 되는 프로파일 키를 이용하여 트랜스코딩 완료 시 콜백 알림을 해당 URL에 전송합니다.</td></tr><tr><td>콘텐츠 업데이트 콜백 URL</td><td>채널에 콘텐츠가 추가, 삭제, 혹은 재생이 되면 콜백 알림을 해당 URL에 전송합니다.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://catenoid-support.gitbook.io/kollus-vod-console-v2/userguide/service-account/callback.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.