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/upcoming?page=0&size=8
담당자
인증 여부에 따른 응답 변경 여부
isLiked(exhibition)
must or should
must
도메인
EXHIBITION

Query Params

Key
Value
page
0
size
8
  • page
    • 0부터 시작합니다. (ex 첫번째 페이지는 page = 0)
    • 기본값 0
  • size
    • 한 페이지당 포함되는 데이터 개수
    • 기본값 8
  • 예시
    • /api/v1/exhibitions/upcoming?page=0&size=8

Response Body

Success

  • 현재 시점을 기준으로 전시회 시작일이 가장 가까운 전시회 반환합니다.
    • 현재 날짜와 전시회 시작일이 같은 경우도 응답에 포함됩니다.
    • 만약 전시회들의 시작일이 같은 경우 종료일이 빠른 전시회가 먼저 오도록 정렬됩니다.
    • 만약 전시회들의 종료일까지 같은 경우 전시회 id 순으로 정렬됩니다.
  • isLiked
    • 로그인하지 않은 경우 OR 좋아요를 누르지 않은 경우 : false
    • 로그인한 상태이며 좋아요를 누른 경우 : true
{ "message": "다가오는 전시회 조회 성공", "code" : 200, "data" : { "content": [ { "exhibitionId" : 2, "name": "*c-lab 6.0 프로젝트 X 박관우 <클럽 리얼리티>", "thumbnail": "https://www.culture.go.kr/upload/rdf/22/07/show_2022071814552019267.jpg", "startDate": "2022-07-29", "endDate": "2022-07-31", "isLiked": false, "likeCount": 4, "reviewCount": 3 }, { "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

  • 500 Server Error - 서버 내부 문제 발생한 경우
{ message: "서버에 문제가 생겼습니다.", status: 500, code: "C000" }