Next API 통합

외부 API 프록시 흐름

외부 API를 클라이언트에서 직접 부르지 않고 API Route를 거치면 비밀 키 보호, 응답 정규화, 캐시 제어를 서버에서 처리할 수 있습니다.

Client1
Route Handler2
External API3
Normalized JSON4
01

요청 수신

클라이언트는 내부 API Route로 필요한 파라미터만 보냅니다.

02

비밀 키 주입

서버에서 환경 변수의 API 키를 붙여 외부 서비스에 요청합니다.

03

응답 정리

외부 응답을 화면에 필요한 필드로 줄이고 오류 형식을 통일합니다.

04

캐시 제어

revalidate, no-store, rate limit 기준을 서버 경계에서 관리합니다.

통합 기준

  • API 키는 클라이언트 번들에 들어가지 않도록 서버 환경 변수에 둡니다.
  • 외부 API 오류 메시지를 그대로 노출하지 말고 내부 오류 형식으로 변환합니다.
  • 요금이 있는 API는 캐싱과 요청 제한을 함께 설계합니다.

서버 역할

secret키 보호
shape응답 정규화
cache비용 절감