v1

latestOpenAPI 3.0.02026-07-24360247.6 KB

ver 2026-05-20

2026-05-20 버전의 클립 목록 조회 API입니다.

get/clips

Query parameters

pageinteger

페이지

limitinteger

1페이지 갯수

state[]string[]

클립 상태 [private, public]

orderSortTypestring

정렬 타입 [createdAtDesc, createdAtAsc]

startedDatestring

등록일 기준 범위검색 시작날짜(IOS) 시작일 ~ 종료일을 입력하지않으면 전범위가 조회됩니다. ex)2026-02-21T15:00:00.000Z

endedDatestring

등록일 기준 범위검색 시작날짜(IOS) 시작일 ~ 종료일을 입력하지않으면 전범위가 조회됩니다. ex)2026-02-21T15:00:00.000Z

affiliateProductIdstring

상품 등록 시 입력했던 상품코드

Headers

authorization string required

인증용 토큰

x-api-version'2026-05-20'

API 버전 (날짜 형식). 미전송 시 가장 오래된 버전이 적용됩니다.

Response

200

timestampinteger

타임스탬프

requestIdstring

요청 ID

Example response

{
  "timestamp": 1736473851211,
  "requestId": "7bdfad33-f800-4e1d-8bb7-060651f9a4ab",
  "data": {
    "count": 209,
    "page": 1,
    "limit": 20,
    "rows": [
      {
        "id": 9854,
        "description": "설명",
        "type": "clip",
        "state": "public",
        "thumbnailUrl": "/2024/12/18/media/test/test.jpg",
        "customThumbnailUrl": "https://stage.resources.sauceclip.com/2024/12/18/thumbnail/test/test.jpg",
        "thumbnailType": "CUSTOM",
        "shortUrl": "https://stage.sclip.us/v2/test",
        "previewUrl": "https://stage.resources.sauceclip.com/2024/12/18/media/test/preview/master.m3u8",
        "resourceUrl": "https://stage.resources.sauceclip.com",
        "isTagUsed": true,
        "curationIds": [
          415
        ],
        "clipSource": {
          "id": 9855,
          "hash": "test",
          "state": "done",
          "duration": 52,
          "size": 14284763,
          "width": 1280,
          "height": 720,
          "previewKey": "/2024/12/18/media/test/preview/master.m3u8",
          "key": "/2024/12/18/media/test/master.m3u8",
          "createdAt": "2024-12-18T00:30:51.000Z"
        },
        "clipTags": [
          {
            "id": 1,
            "tag": "태그"
          }
        ],
        "products": [
          {
            "productId": 91440,
            "productUniqueId": "mobidoo-09c7130ab34e4feba3ab47cdea91ea94",
            "productName": "운영자 등록 상품",
            "brandName": "운영자 등록 상품",
            "countryCode": "KR",
            "price": "0.00",
            "discountType": "none",
            "discountRate": "0.00",
            "discountPrice": "0.00",
            "sellingPrice": "0.00",
            "productStatusCode": "active",
            "redirectUrl": "http://www.naver.com",
            "createdDate": "2024-11-18T08:31:47.000Z",
            "updatedDate": "2024-12-10T06:03:19.000Z"
          }
        ],
        "partnerUniqueId": "mobidoo",
        "user": {
          "id": 1,
          "name": "테스트",
          "identity": "test",
          "partnerAdminUserUniqueId": "2d03fd95e8be47dd95667ae5986becc9"
        },
        "createdAt": "2024-12-18T00:30:51.000Z",
        "updatedAt": "2024-12-18T01:45:46.000Z"
      }
    ]
  }
}