VIDEOPACK API파일드라이브Copy Page업로드 파일 전송post {uploadServer}/contents/v1/upload업로드 토큰 발급에서 받은 업로드 서버 주소(uploadUrl)로 파일을 전송합니다. API Key 없이 토큰으로 인증하며, 전송이 끝나면 업로드 상태 조회로 완료 여부를 확인합니다.Query Paramstokenstringrequired업로드 토큰 (토큰 발급 응답의 token, 한 번의 업로드에만 사용, 발급 후 60분 안에 전송 시작)Body Paramsmultipart/form-data 로 전송합니다. 폼 필드는 folderId → maxAge → overwrite → file 순서로 보냅니다 (file 파트가 마지막 — 파일 뒤에 온 필드가 있으면 실패) 파일명·파일 종류는 file 파트의 값이 그대로 쓰입니다 파일 크기는 요청 크기(Content-Length 헤더)로 판단하므로 따로 보내지 않습니다. Content-Length 가 없는 요청(chunked 전송)은 받지 않습니다 파일은 최대 45GB이며, 빈 파일(0 byte)은 업로드할 수 없습니다 허용 확장자 33종 (대소문자 구분 없음, 확장자 없는 파일은 불가) : html · htm · js · css · json · xml · jpg · jpeg · png · gif · svg · webp · mp4 · mp3 · woff · woff2 · ttf · otf · eot · vtt · smi · srt · pdf · pptx · zip · obj · ffs_db · ico · txt · map · esj · swf · ogg 파일명은 확장자 포함 255자 이내 (글자 수 기준). 금지 : 앞뒤 공백, 이름 전체가 .·.., 문자 / ? \ % ^ # | " [ ] < > { }, 제어 문자·보이지 않는 문자 folderIdinteger저장할 폴더 ID (선택, 기본 0 = 최상위)maxAgeinteger2 to 120CDN 캐시 유지 시간 (시간 단위), 2~120 정수 (선택) 생략하면 새 파일은 24, 덮어쓰기(overwrite=1)는 기존 파일의 값을 유지 범위 밖·정수가 아닌 값은 ERR_INVALID_MAX_AGE 로 거절 overwriteintegerenum1 이면 같은 이름의 파일을 덮어씀 (선택, 기본 0)01Allowed:01filefilerequired업로드할 파일 (필수)Responses 200전송 성공 (등록 전) 응답의 status 는 UPLOADED 입니다. 파일 등록이 끝났는지는 업로드 상태 조회에서 COMPLETE 로 확인합니다 400전송 거절 — 다른 API(isSuccess·message)와 달리 {token, status: "U_ERROR", errorCode} 형식입니다 폴더·이름·같은 이름·용량·허용 확장자를 전송 시작 때 검사하며, 거절하면 errorCode 와 함께 응답하고 연결을 끊습니다 응답을 받지 못하고 연결이 끊긴 경우에는 업로드 상태 조회에서 errorCode 를 확인합니다 주요 errorCode : ERR_NAME_DUPLICATED(같은 이름 존재) · ERR_EXTENSION_NOT_ALLOWED(허용되지 않은 확장자) · ERR_QUOTA_EXCEEDED(용량 초과) · ERR_FILE_TOO_LARGE(파일 크기 초과) · ERR_INVALID_NAME(파일명 규칙 위반·255자 초과) · ERR_NAME_TOO_LONG(폴더 경로와 파일명을 합친 저장 경로가 너무 김) · ERR_FOLDER_DELETING·ERR_FILE_DELETING·ERR_FILE_MOVING(삭제·이동 중) · ERR_FOLDER_NOT_FOUND(폴더 없음·삭제됨·잘못된 폴더 ID) · ERR_EMPTY_FILE(빈 파일) · ERR_INVALID_MAX_AGE(캐시 시간이 2~120 정수가 아님) · ERR_UPLOAD_ABORTED(전송 중단·Content-Length 없음·필드가 파일 뒤에 옴·형식 오류) · ERR_TOKEN_NOT_FOUND(토큰 누락·없음·만료·사용됨 — 이때는 응답에 token 이 없음) 500서버 오류 ({token, status: "U_ERROR", errorCode} 형식) — ERR_UPLOAD_FAILED(저장 실패) · ERR_REGISTER_FAILED(저장 후 등록 요청 실패). 잠시 후 토큰을 새로 발급받아 다시 시도합니다Updated about 13 hours ago 업로드 토큰 발급업로드 상태 조회Did this page help you?YesNo