VIDEOPACK API파일드라이브Copy Page파일 이름 변경·폴더 이동get https://api.v4.wecandeo.com/info/contents/file/v1/update.json파일드라이브 내 파일 이름을 변경하거나 파일을 다른 폴더로 이동합니다. 변경은 백그라운드로 처리되며, 응답의 작업 ID로 진행 상태를 조회합니다.Query Paramsidintegerrequired≥ 0파일 IDfileNamestringlength ≤ 255변경할 파일명 (확장자 포함 255자 이내, 글자 수 기준) fileName, folderId 중 하나 이상 필요 확장자는 변경할 수 없으며, 다른 확장자를 주면 원래 확장자를 뒤에 붙임 (예: ma1.txt 에 renamed.mp4 를 주면 renamed.mp4.txt) 금지 : 앞뒤 공백, 이름 전체가 .·.., 문자 / ? \ % ^ # | " [ ] < > { }, 제어 문자·보이지 않는 문자 빈 값은 400 folderIdinteger≥ 0이동할 폴더 ID (루트 0) fileName, folderId 중 하나 이상 필요 빈 값은 400 (루트로 옮길 때는 0) Responses 200성공 (변경 접수) 진행 상태는 jobId 로 작업 상태 조회 진행 중에 같은 요청을 다시 보내면 진행 중인 jobId 를 반환 (다른 요청이면 409) 400요청 형식 오류, 이름 규칙 위반, 이동할 위치에 같은 이름 존재, 변경 내용 없음(같은 이름·같은 폴더) 403권한 오류 — 원인에 따라 응답 형식이 다릅니다 API Key 누락·잘못된 API Key : {"message": "Forbidden"} 등록되지 않은 API Key : {"isSuccess": false, "message": "Unknown API KEY"} 허용되지 않은 IP : {"isSuccess": false, "errorInfo": {"code": "ERR_OPENAPI_IP_DENIED", "message": "..."}} 파일드라이브를 사용할 수 없는 계정 : {"isSuccess": false, "message": "..."} 트래픽 상한을 넘어도 API·업로드는 막히지 않습니다 (다운로드 URL 만 차단). 업로드를 막는 것은 저장 용량·파일 수 상한(ERR_QUOTA_EXCEEDED)입니다 404대상 없음 409이동·삭제가 진행 중인 대상 429요청 횟수 초과 — API Key당 초당 요청 한도(10회)를 넘은 요청 (API 게이트웨이 응답) 응답 형식 : {"message": "Too Many Requests"} Retry-After 등 재시도 시점을 알려 주는 헤더는 없습니다. 잠시 뒤 다시 요청합니다 Updated about 13 hours ago 파일 상세 조회파일 삭제Did this page help you?YesNo