실패 경계

외부 API 오류 처리

공급자의 응답 형식과 메시지를 그대로 노출하지 않고, 앱의 화면과 로그가 이해하는 형태로 정리합니다.

입력 방어

호출 전 차단

city 같은 필수 쿼리가 없으면 공급자 요청을 만들지 않고 400으로 반환합니다.

searchParams
공급자 응답

상태와 본문 분리

response.ok, status, 오류 본문을 읽어 내부 메시지와 로그 레벨을 결정합니다.

response.status
화면 계약

필드 축소

온도, 습도, 설명처럼 화면이 쓰는 필드만 반환해 공급자 변경 영향을 줄입니다.

processedData
위험
Route Handler 대응
클라이언트 노출
프록시 장애 격리
API 키 누락
환경 변수 검사 후 500
서비스 일시 오류
배포 설정 점검
호출 제한
캐시와 재시도 간격 적용
잠시 후 재시도 안내
사용량 대시보드
응답 구조 변경
필드 존재 검사
표준 오류 JSON
로그 샘플 확인