Gateway Pattern

API 게이트웨이의 외부 계약 경계

인증, 라우팅, 집계, timeout, 관측을 gateway에 두되 도메인 규칙은 하위 서비스 소유로 남겨 서비스 결합을 줄입니다.

Route

외부 라우팅

클라이언트 URL은 gateway가 받고 내부 service endpoint 변경은 숨깁니다.

Auth

공통 인증

JWT 검증과 rate limit은 gateway에서 먼저 적용하고 세부 권한은 서비스에서 다시 확인합니다.

Aggregate

응답 조합

여러 service 호출을 묶을 때 partial failure와 fallback 응답 형태를 명시합니다.

Resilience

장애 차단

timeout, circuit breaker, retry budget 없이는 느린 downstream이 gateway 전체를 막습니다.