프로젝트 검색 Tier 3

GET/api/projects.searchCopied!

API 키에 바인딩된 워크스페이스에서 접근 가능한 프로젝트를 반환합니다.

요청

쿼리

querystringrequired

1–255 characters

검색어

pagenumber

1–100

페이지 번호

Default: 1

sort.typestring

정렬 필드

Possible values: namecreatedAt

Default: createdAt

sort.directionstring

정렬 방향

Possible values: ascdesc

Default: desc

응답

200 OK를 반환합니다.

dataarray

검색된 프로젝트 목록

data[].idstring

프로젝트 ID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62

data[].namestring

프로젝트 이름

Example: Launch Campaign

data[].descriptionstring?

프로젝트 설명

Example: Social assets for Q4 launch

data[].thumbnailstring?

썸네일 URL

Example: https://cdn.youvico.com/projects/launch.png

data[].createdAtstring

프로젝트 생성 일시

Example: 2026-04-10 05:11:44.000000

data[].updatedAtstring

프로젝트 마지막 수정 일시

Example: 2026-04-10 08:20:00.000000

pageobject

페이지네이션 정보

page.currentnumber

현재 페이지 번호

Example: 1

page.hasNextboolean

다음 페이지 존재 여부

Example: false

예시

curl 'https://api.youvico.com/api/projects.search?query=launch&sort.type=createdAt&sort.direction=desc' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
      "name": "Launch Campaign",
      "description": "Social assets for Q4 launch",
      "thumbnail": "https://cdn.youvico.com/projects/launch.png",
      "createdAt": "2026-04-10 05:11:44.000000",
      "updatedAt": "2026-04-10 08:20:00.000000"
    }
  ],
  "page": {
    "current": 1,
    "hasNext": false
  }
}

TIP

이 라우트는 슬래시(projects/search)가 아니라 점으로 구분된 이름(projects.search)을 사용합니다.