큐레이션 목록 조회 명세서입니다.
큐레이션의 목록을 조회하는 API 입니다. 파트너에 등록된 큐레이션과 해당 큐레이션에 포함된 클립 목록을 반환합니다.
API 버전 관리
- 이 API는
x-api-version헤더를 통해 날짜 기반 버전 관리를 합니다. - 해당 헤더가 포함되지 않은 경우, 기본(Default) / 최초 버전이 자동으로 적용됩니다.
| 버전 | 상태 | 설명 |
|---|---|---|
2026-05-20 | 최신 | 최초 버전 |
큐레이션 객체
| 필드 | 타입 | 설명 |
|---|---|---|
| id | int | 큐레이션 ID |
| name | string | 큐레이션 명 |
| isNameVisible | string | 큐레이션 명 공개 여부 |
| description | string | 큐레이션 소개 |
| isDescriptionVisible | string | 큐레이션 소개 공개 여부 |
| orderType | string | 큐레이션 클립 노출 타입 (ord, random) |
| orderSortType | string | 큐레이션 클립 노출 타입이 ord인 경우 정렬 타입 (sortNoAsc, pvDesc, createdAtDesc) |
| viewType | string | 리스트 뷰 타입 (grid, carousel, scroll) |
| playType | string | 재생 타입 (cursor, not, auto) |
| isDisplayProductVisible | boolean | 전시 상품 표시 여부 |
| isPageViewCountVisible | boolean | 조회수(pv) 표시 여부 |
| isPlayButtonVisible | boolean | 재생버튼 표시 여부 |
| isBrandNameVisible | boolean | 브랜드명 노출 여부 |
| state | string | 상태 (public, private) |
| sortNo | int | 큐레이션 노출 타입이 ord이고 sortNoAsc인 경우 정렬 순서 |
| clipList | array | 큐레이션 클립 객체 배열 |
| int | 클립 ID |
| int | 큐레이션 내 클립 순서 |
| partnerUniqueId | string | 파트너 유니크 ID |
| createdAt | string | 생성 날짜 (format:ISO 8601 형식의 UTC) ex) 2025-01-01T00:00:00.000Z |
| deletedAt | string | 삭제 날짜 (format:ISO 8601 형식의 UTC) ex) 2025-01-01T00:00:00.000Z |
| viewTypeColumnNumber | int | 뷰 타입 단 수 |