요약: 사용자의 현재 위치(좌표)를 기반으로 해당 행정구역 정보와 관련 재난 문자 정보를 조회합니다.

경로: /api/disaster-alert

메서드: GET

### 요청 파라미터 (Request Parameter)

Sheets로 내보내기

### 응답 (Response)

• 200 OK: 요청이 성공적으로 처리되었으며, 첫 번째 요소는 사용자 위치 정보, 이후 요소들은 해당 지역의 재난 문자 목록을 반환합니다.

  • **응답 본문 예시 (JSON)**JSON

    [ { "title": "현재 위치", "message": "요청하신 좌표의 행정구역 정보입니다.", "location": "서울특별시 강서구 화곡동", "sendTime": "2025-09-12 21:35:00" }, { "title": "안전안내", "message": "[서울경찰청] 강서구에서 배회중인 현명란씨(여,53세)를 찾습니다...", "location": "서울특별시 강서구 ", "sendTime": "2023/09/16 11:42:02" }, { "title": "안전안내", "message": "[서울특별시청]서남권지역 폭염 주의보 발효, 낮시간대 고온이 예상되오니...", "location": "서울특별시 강서구 ,서울특별시 관악구 ,서울특별시 구로구 ", "sendTime": "2023/09/05 11:10:45" } ]

• 400 Bad Request: lat 또는 lon 파라미터가 누락되었거나 형식이 잘못된 경우 발생합니다.

• 500 Internal Server Error: 서버 내부 오류(외부 API 통신 실패 등)로 인해 요청을 처리할 수 없습니다.

### 💡 상세 동작 설명 (Detailed Logic)

이 API는 클라이언트의 간단한 요청 뒤에서 다음과 같은 상세 로직을 수행합니다.

1. 좌표 변환: lat, lon 값을 받아 카카오 API를 호출, 이를 "서울특별시 강서구"와 같은 행정구역명으로 변환합니다.
2. 데이터 조회 기간: 행정안전부 API 호출 시, 조회 시작일(crtDt)을 현재로부터 7일 전으로 설정하여 최신 데이터만 가져옵니다.
   • 코드: String startDate = LocalDate.now().minusDays(7).format(DateTimeFormatter.ofPattern("yyyyMMdd"));
3. 최대 조회 개수: 행정안전부 API 호출 당 **최대 100개(numOfRows=100)**의 재난문자를 우선적으로 조회합니다.
   • 코드: .queryParam("numOfRows", "100")
4. 지역 필터링: 조회된 재난문자 목록 중, 수신 지역(RCPTN_RGN_NM)에 사용자의 행정구역명이 포함된 문자만 필터링하여 골라냅니다. (RegionMatcher 사용)
5. 응답 데이터 구성: 최종 목록의 첫 번째에는 사용자의 현재 위치 정보를 추가하고, 그 뒤에 필터링된 재난문자 목록을 붙여 클라이언트에게 최종 응답합니다.