API Gateway는 외부 계약을 중앙화하고 내부 도메인은 분리한다

좋은 게이트웨이는 클라이언트에는 단순한 API를 제공하고, 내부 서비스에는 자신의 책임만 남깁니다.

Gateway에 중앙화
인증, 권한, rate limit
HTTP route와 응답 포맷
gRPC/Kafka 오류의 외부 응답 변환
Service에 남김
도메인 규칙과 데이터 소유권
내부 서비스 계약의 실제 처리
장애 원인과 복구 가능한 상태 제공
단일 진입점

클라이언트는 `/api` 계약만 압니다.

내부 호출

Gateway는 필요한 서비스만 호출합니다.

응답 합성

여러 결과를 한 응답으로 정리합니다.

실패 번역

내부 오류를 HTTP 계약으로 바꿉니다.

정리: Gateway는 마이크로서비스 복잡도를 클라이언트에서 감추되, 내부 서비스의 도메인 책임까지 가져오지 않을 때 가장 안정적입니다.