{"templateId":"markdown","versions":[{"version":"3.0","label":"3.0","link":"/products/vod/vod_guide","default":true,"active":true,"folderId":"78c58c4c"}],"sharedDataIds":{"sidebar":"sidebar-products/vod/@3.0/vod.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Kollus VOD API v3 가이드","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Kollus VOD 서비스 연동을 위한 RESTful API 공식 가이드입니다. API 인증 방식부터 Node.js 예제 코드까지, 외부 시스템과의 표준화된 데이터 연동 및 개발 환경 구축을 위한 상세 스펙을 확인하세요."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"vod-api-가이드","__idx":0},"children":["VOD API 가이드"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Kollus VOD는 외부 시스템과의 데이터 연동을 위해 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RESTful API"]},"를 제공합니다."," ","이 가이드에서는 요청 규격과 인증 방식을 설명합니다. Node.js 연동 예제를 참고하여 개발 환경을 구성할 수 있습니다."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"요청-규격","__idx":1},"children":["요청 규격"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"호출-제한","__idx":2},"children":["호출 제한"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["1분당 최대 60회 호출 가능합니다. 연속 호출 시 최소 1초 이상의 간격을 유지해 주세요."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"요청-헤더","__idx":3},"children":["요청 헤더"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HTTP Method에 따라 Accept 헤더와 Content-Type을 지정해야 합니다."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP Method"},"children":["HTTP Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Accept 헤더"},"children":["Accept 헤더"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Content-Type"},"children":["Content-Type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/x-www-form-urlencoded"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"인증-방식","__idx":4},"children":["인증 방식"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["모든 API 요청에는 인증 토큰(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kollus_api_access_token"]},")을 포함해야 합니다."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["토큰 확인 경로"]},": Kollus VOD 콘솔 > [서비스 계정] > ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://c-kr.kollus.com/service-account/api-service","target":"_blank","rel":"noopener noreferrer"},"children":["[API]"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["주의"]},": 새로운 토큰을 발급하면 기존 토큰은 즉시 무효화됩니다. 운영 중인 시스템에서 토큰을 재발급하면 서비스 중단이 발생할 수 있습니다."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/vod_api_guide_1.5e8314ceb88f0a47be9a5712f756aaa3bd8c2cf559d44438d145725095b7faf1.9c1bb791.png","alt":"Kollus VOD 콘솔 화면","framed":false,"withLightbox":false,"width":"100%","border":"1px solid gray"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"요청-url-구성","__idx":5},"children":["요청 URL 구성"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API 엔드포인트 뒤에 인증 토큰을 Query String으로 전달합니다."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"채널-정보-조회-예시","__idx":6},"children":["채널 정보 조회 예시"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://c-api-kr.kollus.com/api/channels/{CHANNEL_KEY}?access_token={KOLLUS_API_ACCESS_TOKEN}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"키key-정보","__idx":7},"children":["키(Key) 정보"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["요청 URL에 포함되는 키 정보는 ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.kollus.com/dev-guide/vod/quickstart/key","target":"_blank"},"children":["인증 및 주요 키"]}," 문서를 참고하세요."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"nodejs-연동-예제","__idx":8},"children":["Node.js 연동 예제"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"패키지-설치","__idx":9},"children":["패키지 설치"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["다음 명령으로 라이브러리를 설치합니다."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ npx api install \"@kollus-vod/v3.0-KR#189zaiumejg7t49\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"채널-생성-post","__idx":10},"children":["채널 생성 (POST)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["새로운 채널을 생성하고 암호화 여부 등 주요 속성을 설정합니다."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"import kollusVod from '@api/kollus-vod';\n\n// Configure authentication\nkollusVod.auth('{KOLLUS_API_ACCESS_TOKEN}');\n\n// Execute channel creation\nkollusVod._9c1ead997f8db167ade85da30910a14c({\n  name: 'new_channel_name',\n  description: 'new_channel_description',\n  is_shared: 0,\n  is_encrypted: 0\n})\n  .then(({ data }) => console.log(data))\n  .catch(err => console.error(err));\n","lang":"js"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"채널-정보-조회-get","__idx":11},"children":["채널 정보 조회 (GET)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["채널 키를 사용하여 특정 채널의 상세 데이터를 조회합니다."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"import kollusVod from '@api/kollus-vod';\n\n// Configure authentication\nkollusVod.auth('{KOLLUS_API_ACCESS_TOKEN}');\n\n// Retrieve specific channel details\nkollusVod._7af1e384be9287f26a99c03a3b8eb2bb({channel_key: '{CHANNEL_KEY}'})\n  .then(({ data }) => console.log(data))\n  .catch(err => console.error(err));\n","lang":"js"},"children":[]}]},"headings":[{"value":"VOD API 가이드","id":"vod-api-가이드","depth":1},{"value":"요청 규격","id":"요청-규격","depth":2},{"value":"호출 제한","id":"호출-제한","depth":3},{"value":"요청 헤더","id":"요청-헤더","depth":3},{"value":"인증 방식","id":"인증-방식","depth":3},{"value":"요청 URL 구성","id":"요청-url-구성","depth":3},{"value":"채널 정보 조회 예시","id":"채널-정보-조회-예시","depth":4},{"value":"키(Key) 정보","id":"키key-정보","depth":3},{"value":"Node.js 연동 예제","id":"nodejs-연동-예제","depth":2},{"value":"패키지 설치","id":"패키지-설치","depth":3},{"value":"채널 생성 (POST)","id":"채널-생성-post","depth":3},{"value":"채널 정보 조회 (GET)","id":"채널-정보-조회-get","depth":3}],"frontmatter":{"seo":{"title":"Kollus VOD API v3 가이드","description":"Kollus VOD 서비스 연동을 위한 RESTful API 공식 가이드입니다. API 인증 방식부터 Node.js 예제 코드까지, 외부 시스템과의 표준화된 데이터 연동 및 개발 환경 구축을 위한 상세 스펙을 확인하세요."}},"lastModified":"2026-07-21T04:58:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/vod/vod_guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}