Get Surveys (설문 목록 조회)

사용 가능한 설문 목록을 조회합니다.

엔드포인트

GET /api/v1/surveys

Query Parameters:

파라미터	타입	필수	설명
title	string	✖	검색어
category	number	✖	설문 카테고리 필터
tags	string[]	✖	설문 태그 필터
page	number	✖	페이지 번호 (기본값: 1)
limit	number	✖	페이지당 결과 수 (기본값: 20)
sort	string	✖	정렬 기준 ( 'POPULARITY', 'LATEST', 'RESULT_COUNT', 'YEARLY', 'MONTHLY' ) (기본 값: 'POPULARITY')

Response:

{
  "code": 200,
  "message": "요청이 성공적으로 완료되었습니다.",
  "surveyList": [
    {
      "id": string,
      "title": string,
      "description": string,
      "thumbnailImageUrl": string
      "tags": string[],
      "questionCount": number,
      "isOfficial": boolean,
      "participantCount": number,
      "viewCount": number,
      "shareCount": number,
      "popularity": number,
      "category": {
        "id": number,
        "name": string
      }
    }
  ],
  "count": number
}

상태 코드

코드	설명
200	요청이 성공적으로 처리됨
400	잘못된 요청 (파라미터 오류 등)
401	인증 오류
404	프로젝트를 찾을 수 없음