이미지 폴더와 이미지 파일의 목록을 조회합니다.
- 과도한 API 요청이 발생하는 경우 사용량이 제한될 수 있습니다.
- 또한 현재 제공 중인 API의 종류 및 내용은 더 나은 API 서비스 제공을 위해 변경 및 업데이트될 수 있습니다.
Request URL
GET https://api.wecandeo.com/image/api/v1/folder/list.json?key={API key}&folder_id={Folder id}
Request Parameters
| Parameter Name | Type | Description |
|---|---|---|
| key (Required) | String | API Key |
| folder_id | Number | 이미지가 포함 된 폴더 ID |
| include | String | 이미지 파일 포함 여부 (파일 목록을 함께 조회하려면 &include=file 설정 필요) |
| page | Number | 페이지 Index (include 사용 시) |
| pagesize | Number | 페이지당 리스트 수 (include 사용 시) |
| search_item | String | 검색 옵션 - filename - id |
| keyword | String | 검색 단어 |
| sort_item | String | 정렬 항목 - filename - udate |
| sort_direction | String | 정렬 옵션 - desc : 내림차순 - asc : 오름차순 |
Response Example
{
data: {
list: [
{
id: 32289,
parent_id: 32288,
max_age: 86400,
content_length:0,
filename: "do999/",
filepath: "do888/do999/",
udate: "2024-06-18 14:28:47",
object_type: "folder"
},
{
id: 31226,
parent_id: 0,
max_age: 86400,
content_length:1234,
filename: "newColor.jpg",
filepath: "https://g-000.img.wecandeo.com/newColor.jpg",
udate: "2024-06-18 14:28:47",
object_type: "file"
}
]
},
paging: {
page: 1,
pagesize: 10,
totalcount: 1,
totalpage: 1
},
errorInfo:{
errorCode: "None",
errorMessage: ""
},
}
Response Data Value
| Name | Type | Description |
|---|---|---|
| id | Number | 폴더 or 파일 ID |
| parent_id | Number | 객체가 포함 된 폴더 ID |
| max_age | Number | 이미지 파일 캐시 시간 (초) |
| content_length | Number | 파일 용량 (Byte) |
| filename | String | 폴더 or 파일 이름 |
| filepath | String | 폴더 or 파일 경로 |
| udate | String | 수정 일자 |
| paging | Object | 페이지 정보를 담은 객체 |
| errorInfo | Object | 에러 정보를 담은 객체 |