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

인증

Authorization
string
header
필수

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

쿼리 매개변수

q
string

상품 이름과 설명에서 대소문자 구분 없이 검색합니다(최대 100자). 일반 텍스트로 비교하므로 %, _는 와일드카드가 아닙니다. NUL 문자(%00)가 포함되면 VALIDATION_ERROR로 거부됩니다.

Maximum string length: 100
status
enum<string>

이 상태의 상품만 반환합니다. archived는 보관된 상품을 나열하고 all은 보관된 상품도 포함합니다.

사용 가능한 옵션:
all,
active,
scheduled,
archived
limit
integer
기본값:20

페이지당 상품 수. 100을 넘는 값은 100으로 조정됩니다.

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

이전 페이지의 nextCursor.

Maximum string length: 512

응답

상품 한 페이지.

data
object[]
필수

이 페이지의 상품 목록입니다.

nextCursor
string | null
필수

다음 페이지를 받으려면 cursor로 전달합니다. 마지막 페이지에서는 null.