메인 콘텐츠로 건너뛰기
GET
폴더 및 강의 목록 조회

인증

Authorization
string
header
필수

Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를 가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한 번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된 키는 바로 다음 요청부터 인증에 실패합니다.

쿼리 매개변수

q
string

제목에 이 텍스트가 포함된 폴더만 조회합니다(대소문자 구분 없음, 1-100자). 일반 텍스트로 비교하므로 %, _는 와일드카드가 아닙니다. NUL 문자(%00)가 포함되면 VALIDATION_ERROR로 거부됩니다.

Required string length: 1 - 100
kind
enum<string>

폴더(folder) 또는 강의(course)만 조회합니다.

사용 가능한 옵션:
folder,
course
limit
integer
기본값:20

페이지 크기, 1-100. 기본값 20이며 더 큰 값은 100으로 처리됩니다.

필수 범위: 1 <= x <= 100
parentId
string

이 폴더(폴더 id) 바로 안에 있는 폴더만 조회합니다. 최상위 폴더만 보려면 root를 사용하세요. 생략하면 중첩된 폴더를 포함한 모든 폴더와 강의를 조회합니다.

cursor
string

이전 페이지의 nextCursor. 불투명한 값이므로 직접 만들거나 수정하지 마세요. 이 API가 발급하지 않은 커서는 400 INVALID_CURSOR(재시도 불가)를 반환합니다.

Maximum string length: 512

응답

폴더와 강의 한 페이지.

data
object[]
필수

이 페이지의 폴더와 코스 목록입니다.

nextCursor
string | null
필수

다음 페이지를 받으려면 cursor로 전달하세요. 마지막 페이지는 null입니다.