폴더 목록 조회

파일드라이브의 폴더 목록을 조회합니다. 조회 방식에 따라 폴더 목록 또는 폴더·파일 목록을 반환합니다. 폴더 탐색 화면처럼 폴더와 파일을 함께 보여 줄 때 사용하고, 한 폴더의 파일만 필요하면 파일 목록 조회를 사용합니다.

Query Params
integer
≥ 0

상위 폴더 ID (루트 0) — 지정하면 그 폴더 바로 아래를 조회

  • 생략했을 때의 동작은 include 참고
  • 없는 폴더는 404, 삭제 중인 폴더는 409
string
enum

조회 방식

  • 생략 : 폴더만 반환 (페이지 없음). parentId 를 빼면 모든 폴더를 한 목록으로 반환 (구조는 parentId·depth 로 확인)
  • file : 바로 아래 폴더 + 파일 목록 (페이지 조회). 폴더를 이름 오름차순으로 먼저 나열하고 이어서 파일을 나열 (totalCount = 폴더 수 + 파일 수). parentId 를 빼면 루트(0) 기준
Allowed:
string

폴더명·파일명 검색어 (include=file 일 때만 사용, 그 밖에 보내면 400)

string
enum

검색 범위 (include=file, q 와 함께 사용)

  • 생략 : 바로 아래 폴더·파일에서 검색
  • subtree : 모든 하위 폴더에서 검색 (파일 위치는 folderId 로 확인)
Allowed:
string
enum
Defaults to cdate

파일 정렬 기준 (include=file 일 때만 사용, 폴더는 이름 오름차순 고정)

Allowed:
string
enum
Defaults to DESC

파일 정렬 방향 (include=file 일 때만 사용, 대소문자 구분)

Allowed:
integer
≥ 1
Defaults to 1

페이지 번호 (include=file 일 때만 사용, 1 이상 정수)

integer
≥ 1
Defaults to 25

페이지당 항목 수 (include=file 일 때만 사용, 1 이상 정수)

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json