상대 경로 호출
브라우저는 /api/weather?city=Seoul처럼 내부 API
라우트만 호출합니다.
External API
Next API 라우트 호출 통제
비밀 키, 요청 검증, 캐싱, 오류 응답을 서버 경계 안에 모으면 클라이언트는 화면 상태 처리에 집중할 수 있습니다.
서버에서 외부 호출
Route Handler가 환경 변수와 검증된 입력으로 외부 API에 요청을 보냅니다.
응답 정책 결정
자주 바뀌지 않는 결과는 캐싱하고 실패 응답은 재시도 여부와 함께 정리합니다.
외부 API 신뢰 경계
속도 제한, 장애, 응답 형식 변경이 발생해도 클라이언트 계약이 흔들리지 않게 서버에서 완충합니다.
프록시 시크릿·CORS 점검
환경개발, 스테이징, 운영 환경의 엔드포인트와 키를 분리합니다.
제한요청 빈도와 캐시 주기를 외부 API 정책에 맞춥니다.
로그실패 원인과 외부 상태 코드를 서버 로그에 남깁니다.