업로드 파일 전송

업로드 토큰 발급에서 받은 업로드 서버 주소(uploadUrl)로 파일을 전송합니다. API Key 없이 토큰으로 인증하며, 전송이 끝나면 업로드 상태 조회로 완료 여부를 확인합니다.

Query Params
string
required

업로드 토큰 (토큰 발급 응답의 token, 한 번의 업로드에만 사용, 발급 후 60분 안에 전송 시작)

Body Params

multipart/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자 이내 (글자 수 기준). 금지 : 앞뒤 공백, 이름 전체가 .·.., 문자 / ? \ % ^ # | " [ ] < > { }, 제어 문자·보이지 않는 문자
integer

저장할 폴더 ID (선택, 기본 0 = 최상위)

integer
2 to 120

CDN 캐시 유지 시간 (시간 단위), 2~120 정수 (선택)

  • 생략하면 새 파일은 24, 덮어쓰기(overwrite=1)는 기존 파일의 값을 유지
  • 범위 밖·정수가 아닌 값은 ERR_INVALID_MAX_AGE 로 거절
integer
enum

1 이면 같은 이름의 파일을 덮어씀 (선택, 기본 0)

Allowed:
file
required

업로드할 파일 (필수)

Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json