> 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 호출 방법

콜러스 연동 시 가장 처음 연동할 V/G 호출하는 방안에 대한 가이드입니다.

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 링크 방식과 레퍼러 차단 기능은 함께 사용할 수 없습니다.**
