# 채널 관리

## 채널 목록 조회

 - [GET /channels](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/getchannels.md): 전체 채널 목록을 조회합니다. 채널 종류(kind) 또는 활성화 상태(status)를 기준으로 필터링할 수 있습니다.

## 신규 채널 생성

 - [POST /channels](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/createchannel.md): 새로운 채널을 생성합니다. 공유 및 보안 정책 설정은 생성 후 변경이 불가능합니다.

## 채널 정보 조회

 - [GET /channels/{channel_key}](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/getchannel.md): 특정 채널의 상세 정보를 조회합니다.

## 채널 정보 수정

 - [PUT /channels/{channel_key}](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/updatechannel.md): 기존 채널의 이름, 설명, 스트리밍 규격 설정을 수정합니다.

## 채널 삭제

 - [DELETE /channels/{channel_key}](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/deletechannel.md): 특정 채널을 시스템에서 영구적으로 삭제합니다. 이 작업은 연동된 콘텐츠 접근에 기술적 영향을 미칠 수 있습니다. (관련 문서: 채널 삭제)

## 채널-콘텐츠 연결

 - [POST /channels/{channel_key}/media-contents/{upload_file_key}/attach](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/attachmediacontenttochannel.md): 콘텐츠를 특정 채널에 연결합니다.

## 채널-콘텐츠 연결 해제

 - [DELETE /channels/{channel_key}/media-contents/{upload_file_key}/detach](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/detachmediacontentfromchannel.md): 채널과 콘텐츠의 연결 상태를 해제합니다.

## 채널-플레이어 스킨 연결

 - [POST /channels/{channel_key}/player-skins/{skin_id}/attach](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/attachplayerskintochannel.md): 플레이어 스킨을 특정 채널에 연결합니다. 만약 채널에 이미 연결된 스킨이 있다면, 시스템은 기존 스킨을 해제하고 새로운 스킨으로 교체합니다.

## 채널-플레이어 스킨 연결 해제

 - [DELETE /channels/{channel_key}/player-skins](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/detachplayerskinfromchannel.md): 채널과 플레이어 스킨의 연결 상태를 해제합니다.

## 콜백 URL 설정 (콘텐츠 추가/삭제, 재생)

 - [PUT /channels/{channel_key}/callback](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/updatechannelcallback.md): 콘텐츠의 추가/삭제 또는 재생 요청 이벤트 발생 시 외부 서버로 정보를 전달하기 위한 엔드포인트(URL)를 설정합니다.

## 콜백 URL 설정 (다운로드)

 - [PUT /channels/{channel_key}/download-callback](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/updatechanneldownloadcallback.md): PC 및 모바일 환경에서 콘텐츠 다운로드 시도가 발생할 때 서버 간 연동을 위한 콜백 URL을 설정합니다.

## 외부 디스플레이 출력 차단

 - [PUT /channels/{channel_key}/security](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/updatechannelsecurity.md): 채널에 속한 콘텐츠 재생 시 HDMI나 미러링 등을 통한 외부 출력(TV-OUT)의 차단 여부를 설정합니다.

## 레퍼러 기반 접근 제어

 - [PUT /channels/{channel_key}/referer](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/updatechannelreferer.md): 특정 도메인에서만 재생을 허용하거나 차단하도록 레퍼러(Referer) 기반 접근 제어 정책을 적용합니다.

## 채널별 콘텐츠 목록 조회

 - [GET /channels/{channel_key}/media-contents](https://kollus-api.redocly.app/products/vod/openapi/%EC%B1%84%EB%84%90-%EA%B4%80%EB%A6%AC/getchannelmediacontents.md): 특정 채널에 등록된 콘텐츠 목록을 조회합니다. 쿼리 파라미터를 활용하여 결과를 필터링할 수 있습니다.

## 채널별 콘텐츠 목록 조회

 - [GET /channels/{channel_key}/media-contents](https://kollus-api.redocly.app/products/vod/openapi/%EC%BD%98%ED%85%90%EC%B8%A0-%EA%B4%80%EB%A6%AC/getchannelmediacontents.md): 특정 채널에 등록된 콘텐츠 목록을 조회합니다. 쿼리 파라미터를 활용하여 결과를 필터링할 수 있습니다.

## 채널-플레이어 스킨 연결

 - [POST /channels/{channel_key}/player-skins/{skin_id}/attach](https://kollus-api.redocly.app/products/vod/openapi/%ED%94%8C%EB%A0%88%EC%9D%B4%EC%96%B4-%EA%B4%80%EB%A6%AC/attachplayerskintochannel.md): 플레이어 스킨을 특정 채널에 연결합니다. 만약 채널에 이미 연결된 스킨이 있다면, 시스템은 기존 스킨을 해제하고 새로운 스킨으로 교체합니다.

## 채널-플레이어 스킨 연결 해제

 - [DELETE /channels/{channel_key}/player-skins](https://kollus-api.redocly.app/products/vod/openapi/%ED%94%8C%EB%A0%88%EC%9D%B4%EC%96%B4-%EA%B4%80%EB%A6%AC/detachplayerskinfromchannel.md): 채널과 플레이어 스킨의 연결 상태를 해제합니다.