HomeAboutMeBlogGuest
© 2025 Sejin Cha. All rights reserved.
Built with Next.js, deployed on Vercel
♥️
2기 최종 프로젝트 팀별 공간
/
[팀 BackFro💯] ArtZip: 세상 모든 전시회를 한 번에
[팀 BackFro💯] ArtZip: 세상 모든 전시회를 한 번에
/
🚀
API 명세
/
전시회 검색

전시회 검색

사용되는 페이지
모든 페이지
검색 결과
HTTP Method
GET
설명
전시회 검색
인증 필요 여부
완료 여부
완료
URL
/api/v1/exhibitions?query=번아웃증후군&page=0&size=8
담당자
인증 여부에 따른 응답 변경 여부
isLiked(exhibition)
must or should
must
도메인
EXHIBITION

Query Params

Key
Value
query(필수)
번아웃증후군
include-end
true/false
page
0
size
8
  • query
    • 검색어(전시회 제목)
  • page
    • 0부터 시작합니다. (ex 첫번째 페이지는 page = 0)
    • 기본값 0
  • size
    • 한 페이지당 포함되는 데이터 개수
    • 기본값 8
  • include-end
    • 종료된 전시회도 포함하는 경우 true
    • 종료된 전시회를 포함하지 않는 경우 false
    • 기본 값 true
  • 예시
    • 종료된 전시회 포함
      • /api/v1/exhibitions?query=번아웃증후군&page=0&size=8&include-end=true
    • 종료된 전시회 제외
      • /api/v1/exhibitions?query=번아웃증후군&page=0&size=8&include-end=false

Response Body

Success

  • 종료된 전시회도 결과에 포함됩니다.
  • isLiked
    • 로그인하지 않은 경우 OR 좋아요를 누르지 않은 경우 : false
    • 로그인한 상태이며 좋아요를 누른 경우 : true
{ "message": "전시회 검색 성공", "status": 200, "data": { "content": [ { "exhibitionId" : 1, "name": "번아웃증후군", "thumbnail": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071816261910020.jpg", "startDate": "2022-08-04", "endDate": "2022-08-10", "isLiked": false, "likeCount": 5, "reviewCount": 3 } ], numberOfElements: 2, //content의 요소가 몇개인지 offset: 0, // 현재 페이지에서 시작하는 요소의 index 번호 pageNumber: 0, //페이지 넘버 pageSize: 20, //페이지 사이즈 totalElements: 2, // 전체 요소 수 totalPages: 1 //전체 페이지 수 } }
 

Failure

  • 400 Bad Request
    • 검색어 길이가 2글자 미만시 발생
    • null, “”, “ “ 입력시 발생
{ message: "검색어는 필수입니다.(2 <= 검색어)", status: 400, code: "EX016" }
  • 500 Server Error - 서버 내부 문제 발생한 경우
{ message: "서버에 문제가 생겼습니다.", status: 500, code: "C000" }