> For the complete documentation index, see [llms.txt](https://catenoid-support.gitbook.io/developer-welcome-kit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://catenoid-support.gitbook.io/developer-welcome-kit/undefined/videogateway.md).

# VideoGateway 호출 방법

1. 미디어컨텐츠키 호출 방식(공유링크)

```
VOD Example)https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}
```

```
Live Example)https://v-live-kr.kollus.com/{CHANNEL_KEY}
```

* 위 주소처럼 V/G 뒷 주소에 미디어 컨텐츠 키를 직접 붙여 호출하는 방식
* 채널 설정이 공유일 경우 사용 가능
* iframe 내 src로 사용하거나 브라우저 주소 입력란에 넣고 사용할 수 있습니다.

2. S Link 호출 방식

```
VOD Example)https://v.kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
```

```
Live Example)https://v-live-kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
```

* Kollus JWT를 사용하여 암호화 URL로 호출하는 방식
* 채널 설정 공유 및 비공유 모두 이용 가능
* iframe 내 src로 사용하거나 브라우저 주소 입력란에 넣고 사용할 수 있습니다.

3. SR 링크 호출 방식

```
VOD Example)https://v.kr.kollus.com/sr?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
```

```
Live Example)https://v-live-kr.kollus.com/sr?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
```

* 위와 같은 방식으로 컨텐츠 호출 시 실제 mp4 / m3u8 주소로 302 리다이렉션 호출
* 자체 플레이어에서 재생  혹은 컨텐츠 다운로드를 위해 사용하는 호출 방식
* 리다이렉트된링크는 2일간 외부에서 호출이 없을 경우 삭제되므로  이 링크를 저장하여 사용하는 방식은 권장하지 않습니다
* sr 링크의 헤더 정보를 읽어 리다이렉트된  주소를 불러오기를 권장 합니다.
* **SR 링크와 레퍼러 차단 기능은 함께 사용할 수 없습니다.**

4. SI 링크 호출 방식

```
VOD Example)https://v.kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
```

```
Live Example)https://v-live-kr.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_USER_KEY}
```

* intent 혹은 kollus scheme로 콜러스 앱에 재생하기 위한 컨텐츠 정보를 전달하기 위한 호출 방식입니다.
* 모바일 플레이어 호출 방식은 이 [링크](/developer-welcome-kit/undefined/undefined-1.md)를 참고 부탁드립니다.

5. I 링크 호출 방식(공유링크)

```
VOD Example)https://v.kr.kollus.com/i/{MEDIA_CONTENT_KEY}
```

```
Live Example)https://v-live-kr.kollus.com/i/{MEDIA_CONTENT_KEY}
```

* si 링크와 비슷한 방식으로 공유 링크 방식으로 콜러스 모바일플레이어에 재생 정보를 전달하기 위한 호출 방식
* 모바일 플레이어 호출 방식은 이 [링크](/developer-welcome-kit/undefined/undefined-1.md)를 참고 부탁드립니다.

6. R 링크 호출 방식(공유링크)

```
VOD Example)https://v.kr.kollus.com/r/{MEDIA_CONTENT_KEY}
```

```
Live Example)https://v-live-kr.kollus.com/r/{MEDIA_CONTENT_KEY}
```

* sr 링크와 비슷한 방식으로 실제  mp4 / m3u8 주소를 공유 링크 방식으로 획득하기 위한 호출 방식
* 자체 플레이어에서 재생  혹은 컨텐츠 다운로드를 위해 사용하는 호출 방식
* 리다이렉트된컨텐츠 링크는 2일간 외부에서 호출이 없을 경우 삭제되므로 리다이렉트링크를 저장하여 사용하는 방식은 권장하지 않습니다
* r 링크를 호출한  뒤 헤더 정보를 읽어 리다이렉트된주소를 불러오기를 권장 합니다.
* r 링크 방식을 사용하기 위해서는 담당 PE 또는 <tech_support@catenoid.net> 으로 문의주시기 바랍니다.
* **R 링크 방식과 레퍼러 차단 기능은 함께 사용할 수 없습니다.**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/developer-welcome-kit/undefined/videogateway.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.
