API Boundary

외부 API 통합은 서버 경계에서 네 가지 결정을 고정한다

Route Handler는 클라이언트 요청을 그대로 전달하는 통로가 아니라, 비밀 키 보호, 입력 검증, 오류 변환, 캐시 정책을 한곳에 모으는 운영 경계입니다.

01

입력 검증

city 같은 필수 쿼리를 확인하고 잘못된 요청은 400으로 돌립니다.

request
02

비밀 키 주입

OPENWEATHER_API_KEY는 서버에서만 읽고 외부 요청에 붙입니다.

server only
03

오류 변환

외부 API의 원본 오류를 내부 메시지와 상태 코드로 정리합니다.

error map
04

캐시 정책

요금과 신선도에 맞춰 no-store, revalidate, rate limit을 정합니다.

cache

클라이언트가 맡을 일

  • 상대 경로로 내부 API만 호출합니다.
  • loading, error, empty 상태를 화면에 표현합니다.
  • 외부 서비스의 키나 원본 엔드포인트를 알 필요가 없습니다.

서버 경계 점검

검증 실패 요청 형식 문제는 400 계열로 빠르게 반환
외부 실패 외부 상태를 내부 오류 형식으로 매핑
성공 응답 필요한 필드만 정규화해 JSON으로 반환