파일드라이브

VIDEOPACK API for 파일드라이브

파일드라이브의 폴더·파일을 만들고 업로드·이동·삭제하며, 진행 상태를 확인하는 API입니다.

이용 대상

Enterprise 요금제에서 파일드라이브 사용이 설정된 계정만 이용할 수 있습니다. 그 밖의 계정은 403으로 응답합니다.

업로드 순서

  1. 업로드 토큰 발급 — 토큰과 업로드 주소(uploadUrl)를 받습니다. 60분 안에 전송을 시작해야 합니다.
  2. 업로드 파일 전송 — uploadUrl로 파일을 보냅니다.
  3. 업로드 상태 조회 — COMPLETE 또는 U_ERROR가 될 때까지 2초 간격으로 확인합니다.

이동·삭제는 백그라운드 처리

파일 이름 변경·이동, 파일 삭제, 폴더 삭제는 바로 끝나지 않고 작업 ID(jobId)를 돌려줍니다. 작업 상태 조회로 DONE·PARTIAL·FAILED가 될 때까지 5초 간격으로 확인합니다.

요청 방식

모든 요청은 GET 쿼리 파라미터로 보냅니다(업로드 파일 전송만 POST). 업로드 파일 전송을 뺀 모든 요청에 x-api-key 헤더가 필요합니다.

공통 제한

  • 요청은 API Key당 초당 10회까지
  • 일괄 삭제는 한 번에 폴더 10개, 파일 100개까지

API 목록