내 주변의 전시회 조회

사용되는 페이지

메인

HTTP Method

GET

설명

내 주변의 전시회

인증 필요 여부

완료 여부

완료

URL

/api/v1/exhibitions/aroundme?lat=37.4924&lng=127.0293&dist=3

담당자

인증 여부에 따른 응답 변경 여부

isLiked(exhibition)

must or should

should

도메인

EXHIBITION

Query Params

lat(위도)

기본값 37.492001

lng(경도)

기본값 127.029704

dist: 반경

단위는 km입니다.
기본값 3

Key	Value
lat	37.492001
lng	127.029704
dist	3

예시1)


/api/v1/exhibitions/aroundme

예시2)


/api/v1/exhibitions/aroundme?lat=37.4924&lng=127.0293&dist=3

Response Body

Success

반경 3km(임시로 지정) 이내의 종료되지 않은 전시회 정보를 반환합니다.


{
    "message": "내 주변의 전시회 조회 성공",
    "code" : 200,
    "data" : {
        "exhibitions": [
            {
                "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": true,
                "likeCount": 5,
                "reviewCount": 3,
								"placeAddr": "서울특별시 종로구 자하문로41길 4 갤러리라온",
								"lat": "37.597625",
								"lng": "126.962292"
            }
        ]
    }
}

Failure

400 Bad Request

잘못된 범위의 위도 경도를 전달한 경우


{
  "status": 400,
  "code": "EX019",
  "message": "옳지 않은 위도 경도 정보입니다.(-90 <= 위도 <= 90, -180 <= 경도 <= 180)"
}

잘못된 범위의 거리를 전달한 경우


{
  "status": 400,
  "code": "EX020",
  "message": "거리는 0 이상이어야 합니다."
}

500 Server Error - 서버 내부 문제 발생한 경우


{
    message: "서버에 문제가 생겼습니다.",
    status: 500,
    code: "C000"
}