메인 콘텐츠로 건너뛰기
GET
cURL

인증

Authorization
string
header
필수

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

쿼리 매개변수

q
string

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

Required string length: 1 - 200
status
enum<string>

이 상태의 문서만 반환합니다. 문서는 고정 만료일이 지난 뒤에만 expired가 되며, 만료 시각 정확히 그 순간에는 아직 live입니다.

사용 가능한 옵션:
live,
draft,
inactive,
expired
kind
enum<string>

이 종류의 문서만 반환합니다.

사용 가능한 옵션:
notion,
pdf,
upload,
post,
form
createdAfter
string<date-time>

이 시각 이후(해당 시각 포함)에 생성된 문서만 반환합니다.

createdBefore
string<date-time>

이 시각 이전(해당 시각 제외)에 생성된 문서만 반환합니다.

limit
integer
기본값:20

페이지당 문서 수입니다. 100을 넘는 값은 100으로 처리됩니다.

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

이전 페이지의 nextCursor 값입니다.

Maximum string length: 512

응답

문서 한 페이지입니다.

data
object[]
필수

이 페이지의 문서 목록이며 최신순입니다.

nextCursor
string | null
필수

다음 페이지를 가져오려면 cursor로 전달하세요. 마지막 페이지에서는 null입니다.