이미지 폴더 및 이미지 목록 조회

이미지 폴더와 이미지 파일의 목록을 조회합니다.

🚧

  • 과도한 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 NameTypeDescription
key (Required)StringAPI Key
folder_idNumber이미지가 포함 된 폴더 ID
includeString이미지 파일 포함 여부
(파일 목록을 함께 조회하려면 &include=file 설정 필요)
pageNumber페이지 Index (include 사용 시)
pagesizeNumber페이지당 리스트 수 (include 사용 시)
search_itemString검색 옵션

- filename
- id
keywordString검색 단어
sort_itemString정렬 항목

- filename
- udate
sort_directionString정렬 옵션

- 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

NameTypeDescription
idNumber폴더 or 파일 ID
parent_idNumber객체가 포함 된 폴더 ID
max_ageNumber이미지 파일 캐시 시간 (초)
content_lengthNumber파일 용량 (Byte)
filenameString폴더 or 파일 이름
filepathString폴더 or 파일 경로
udateString수정 일자
pagingObject페이지 정보를 담은 객체
errorInfoObject에러 정보를 담은 객체