개요
Kollus HTTP 업로드 Endpoint는 고객사가 업로드를 원하는 시점에 Kollus Open API의 일회성 업로드 URL 발급 API를 호출하여 획득한 업로드 URL로 HTTP multipart/form-data 형식으로 파일을 업로드하여, 이후 과정 (트랜스코딩) 을 진행토록 합니다.
...
생성된 업로드 URL, 업로드 파일키는 일회용입니다.
생성된 업로드 파일키는 지정된 시간 이후 자동 폐기됩니다.
요청규격
업로드 엔드포인트 생성 API
일반 업로드 URL : https://c-api-kr.kollus.com/api/upload/create-url
패스쓰루, 파일라이브 업로드 URL : http(s)://upload.kr.kollus.com/api/v1/create_url
Query Parameters
access_token (API 접근토큰)
업로드 URL 발급 요청시에는 다음과 같은 파라미터를 설정할 수 있습니다. Request는 Kollus API 정책에 따라 HTTP(80), HTTPS(443), POST Method만 지원합니다.
POST key | Data type | 기본값 | 비고 | ||||
|---|---|---|---|---|---|---|---|
expire_time | integer | 600 (초) | 값의 범위는 0 < expire_time <= 21600 입니다. 빈값을 보내거나 항목 자체를 제거하면 기본 600초로 설정됩니다. | ||||
category_key | string | (없음) | 업로드한 파일이 속할 카테고리의 키입니다. 빈값을 보내거나 항목 자체를 제거하면 ‘없음’에 속합니다. 파일라이브 업로드의 경우 콜러스 VOD의 Kollus_FileLive 카테고리의 키를 지정합니다. | ||||
title | string | (없음) | 입력한 제목을 컨텐츠의 제목으로 강제지정합니다. 이 값을 보내지 않거나 빈 값으로 보내면 기본적으로 파일명이 제목으로 사용됩니다. is_passthrough를 1로 설정시 title은 원본파일명으로 지정됩니다. | ||||
is_encryption_upload | integer | 0 (일반) | 0은 일반 업로드, 1은 암호화 업로드입니다. 암호화 업로드시 파일이 암호화 되어 Kollus의 전용 플레이어로만 재생됩니다. Security-pack이 적용되지 않은 서비스 계정에서 이 값을 1로 지정하여 요청한 경우는 업로드 URL 생성이 실패합니다. | ||||
is_audio_upload | integer | 0 (비디오) | 0은 비디오 업로드, 1은 음원 파일 업로드 입니다. | is_multipart_upload | integer | 0 (일반) | 파일의 분할 업로드를 지원하기 위한 값입니다. 추후 제공될 기능이며, 현재는 동작하지 않습니다. |
is_passthrough | integer | 0 | 1은 passthrough 업로드, 0은 일반 업로드 입니다. | ||||
profile_key | string | (패스쓰루 사용 시 필수) | is_passthrough가 1인 경우 의미가 있습니다. (profile_key={계정명}-pc-high) 설정->고급기능->인코딩 프로파일에서 확인가능합니다. | ||||
selected_profile_key | String | (없음) | 파일라이브의 업로드 경우에만 사용 합니다. 값 : (서비스계정키)-filelive 콜러스 라이브의 파일라이브가 활성화 상태에만 유효 합니다. |
...