미디어 보관함에 이미지 파일을 업로드합니다.
- 과도한 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 | 에러 정보를 담은 객체 |