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

🚧

과도한 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	에러 정보를 담은 객체