이미지 파일 업로드

미디어 보관함에 이미지 파일을 업로드합니다.

🚧

과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.

또한 현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트될 수 있습니다.

Request URL

POST https://api.wecandeo.com/image/api/v1/file/upload.json?key={API key}

Request Parameters

Parameter Name	Type	Description
key (Required)	String	API Key
file (Required)	multipart/form-data	이미지 파일
id	Number	파일 ID (이미지 파일 교체 시 사용)
folder_id	Number	폴더 ID – 미입력 시 최상위로 지정 ※ 이미지 파일 교체 시에는 사용하지 않음
max_age	Number	이미지 캐시 시간 (초) – default : 86400

⚠️
업로드 데이터는 캐시 시간 설정(max_age)에 따라 갱신되며, 이미지 파일 교체 시 캐시 시간에 따라 조회되는 이미지 파일의 반영이 지연될 수 있습니다.
캐시 시간(max_age)은 업로드 시 7200 ~ 86400의 범위에서 설정 가능합니다.

Response Example

{
  errorInfo:{
    errorCode: "None",
    errorMessage: ""
  },
  status: "Success",
  data:{
    info:{
      id: 32263,
      parent_id: 31232,
      max_age: 86400,
      content_length:1234,
      filename: "test.jpg",
      filepath: "https://g-000.img.wecandeo.com/test.jpg",
      udate: "2024-06-18 14:28:47"
    }
  }
}

Response Data Value

Name	Type	Description
id	Number	파일 ID
parent_id	Number	이미지가 포함 된 폴더 ID
max_age	Number	이미지 파일 캐시 시간 (초)
content_length	Number	파일 용량 (Byte)
filename	String	파일 이름
filepath	String	파일 경로
udate	String	수정 일자
status	String	성공 여부 Success / Fail
errorInfo	Object	에러 정보를 담은 객체