특정 큐레이션에 등록된 클립 목록을 페이지네이션으로 조회하는 API 입니다. 공개 상태(public)이고 전시 기간 내에 있는 클립만 반환됩니다.

📘

사전 조건

• partnerUniqueId는 계정 정보 가져오기 API를 통해 확인할 수 있습니다.
• curationId는 큐레이션 목록 조회 API를 통해 확인할 수 있습니다.

---

API 버전 관리

• 이 API는 x-api-version 헤더를 통해 날짜 기반 버전 관리를 합니다.
• 해당 헤더가 포함되지 않은 경우, 기본(Default) / 최초 버전이 자동으로 적용됩니다.

---

공통 가이드

클립 썸네일 리사이즈 처리

클라이언트의 퍼포먼스와 로딩 속도 최적화를 위해, 실제 렌더링 영역에 맞는 사이즈로 이미지를 요청해야 합니다. 대상 필드는 thumbnailFullUrl, customThumbnailFullUrl 입니다.

1. 썸네일 이미지 URL 선택 기준

2. 리사이즈 쿼리 파라미터 적용

선택된 이미지 URL 뒤에 w(너비), h(높이), f(포맷) 쿼리 파라미터를 추가합니다.

// 원본
"https://resources.sauceclip.com/2025/11/4/media/I6BhEsbM/I6BhEsbM.jpg"

// 9:16 비율 webp 리사이즈
"https://resources.sauceclip.com/2025/11/4/media/I6BhEsbM/I6BhEsbM.jpg?w=180&h=320&f=webp"

channelThumbnailUrl(프로필 이미지)에도 동일하게 적용 가능합니다. (예: ?w=50&h=50&f=webp)

클립 플레이어 링크

응답의 shortUrl을 사용하여 클립 플레이어로 이동하거나, partnerUniqueId와 id를 조합하여 직접 링크를 구성할 수 있습니다.

// shortUrl 사용
"https://sclip.us/v2/hash/BahwiEHce2"

// 직접 조합
"https://player.sauceclip.com/player?partnerUniqueId=shopby_test&clipId=13038"