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
  • 예시

Response Body

Success

  • 현재 시점을 기준으로 전시회 시작일이 가장 가까운 전시회 반환합니다.
    • 현재 날짜와 전시회 시작일이 같은 경우도 응답에 포함됩니다.
    • 만약 전시회들의 시작일이 같은 경우 종료일이 빠른 전시회가 먼저 오도록 정렬됩니다.
    • 만약 전시회들의 종료일까지 같은 경우 전시회 id 순으로 정렬됩니다.
  • isLiked
    • 로그인하지 않은 경우 OR 좋아요를 누르지 않은 경우 : false
    • 로그인한 상태이며 좋아요를 누른 경우 : true

Failure

  • 500 Server Error - 서버 내부 문제 발생한 경우
/api/v1/exhibitions/upcoming?page=0&size=8
{
    "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 //전체 페이지 수
    }
}
{
    message: "서버에 문제가 생겼습니다.",
    status: 500,
    code: "C000"
}