REST API, HTTP API 및 WebSocket API 비교

Amazon API 게이트웨이는 어떤 규모에서든 API를 생성, 게시, 보호하고 모니터링할 수 있는 완전 관리형 서비스입니다. 이 서비스는 백엔드 서비스(Lambda 함수, EC2 인스턴스, HTTP 백엔드 또는 모든 AWS 서비스)의 현관 역할을 합니다. API 게이트웨이는 트래픽 관리, 권한 부여, 스로틀링, 모니터링, API 버전 관리를 처리하므로 백엔드는 API 인프라 문제보다 비즈니스 로직에 집중할 수 있습니다.

REST API(기존 API 게이트웨이 제품)는 가장 폭넓은 기능을 제공합니다. 여기에는 매핑 템플릿을 사용한 요청/응답 변환, 메서드별 스로틀링, API 키를 사용하는 사용량 계획, 응답 캐싱, WAF 통합, X-Ray 추적, 리소스 정책, 클라이언트 인증서 상호 TLS가 포함됩니다. REST API는 Lambda, HTTP, AWS 서비스, Mock, Lambda Proxy 등 모든 통합 유형을 지원합니다. 변환, 캐싱 또는 사용량 계획 같은 고급 기능이 필요할 때 REST API를 사용하십시오.

HTTP API는 REST API보다 더 단순하고 저렴하며 빠른 대안으로 설계되었습니다. Lambda 프록시와 HTTP 프록시 통합만 지원하며, AWS 서비스 통합과 모의 통합은 지원하지 않습니다. 주요 장점은 REST API보다 최대 70% 낮은 비용, 더 짧은 지연 시간, 기본 제공되는 OIDC 및 OAuth 2.0 JWT 권한 부여 기능(일반적인 인증 시나리오에서는 Lambda 권한 부여자가 필요하지 않음), 자동 배포입니다. 캐싱, 사용량 계획 또는 요청/응답 변환이 필요하지 않다면 HTTP API가 더 나은 선택입니다.

WebSocket API는 클라이언트와 서버 사이에 지속적인 양방향 연결을 유지합니다. 요청-응답 방식인 HTTP와 달리 WebSocket을 사용하면 클라이언트가 폴링하지 않아도 서버가 언제든 연결된 클라이언트에 메시지를 푸시할 수 있습니다. API 게이트웨이는 WebSocket 연결을 관리하고 경로 표현식에 따라 메시지를 Lambda 함수로 라우팅합니다. 채팅 앱, 실시간 대시보드, 공동 편집, 게임, 주식 시세 표시기 같은 실시간 애플리케이션에는 WebSocket API를 사용하십시오.

WebSocket API에는 세 가지 기본 제공 경로가 있습니다. $connect는 클라이언트가 연결을 열 때 트리거되고, $disconnect는 연결이 닫힐 때 트리거되며, $default는 일치하지 않는 메시지를 처리합니다. sendmessage처럼 특정 Lambda 함수에 매핑되는 사용자 지정 경로를 추가할 수도 있습니다. @connections 관리 API를 사용하면 Lambda 함수에서 클라이언트의 연결 ID를 이용해 연결된 클라이언트로 메시지를 보낼 수 있습니다.

주요 차이점은 다음과 같습니다.

• REST API: 모든 기능(캐싱, 사용량 계획, 변환, WAF)을 제공하며 비용이 더 높고 모든 통합 유형을 지원합니다.
• HTTP API: Lambda/HTTP 프록시만 지원하고 비용이 70% 저렴하며 JWT 인증이 기본 제공되고 지연 시간이 짧지만 캐싱과 사용량 계획은 지원하지 않습니다.
• WebSocket API: 지속적인 양방향 연결을 제공하고 서버 푸시가 가능하며, 메시지 100만 개당 및 연결 시간 1분당 요금이 부과됩니다.

SAA-C03 시험에서는 다음과 같이 판단하십시오. 실시간 기능이나 고급 기능이 없는 HTTP 관련 질문 → HTTP API. 실시간 푸시 → WebSocket. 복잡한 API 기능 → REST API.

API 게이트웨이 API는 스테이지에 배포됩니다(예: dev, staging, prod). 각 스테이지에는 고유한 URL과 스로틀링 설정이 있으며 특정 배포 스냅샷을 참조할 수 있습니다. 스테이지 변수(환경 변수와 유사)를 사용하면 스테이지별 백엔드 엔드포인트를 매개변수화할 수 있습니다. 예를 들어 API 구성을 복제하지 않고도 dev 스테이지는 개발용 Lambda 별칭을, prod는 운영용 별칭을 가리키도록 할 수 있습니다.

기본적으로 API 게이트웨이 URL에는 API ID가 포함됩니다(예: abc123.execute-api.us-east-1.amazonaws.com). 운영 환경에서는 ACM 인증서를 기반으로 사용자 지정 도메인 이름을 만들고 이를 API 및 스테이지에 매핑하십시오. 기본 경로 매핑을 사용하면 하나의 도메인에서 여러 API를 호스팅할 수 있습니다(예: api.example.com/orders → 주문 API, api.example.com/users → 사용자 API). 사용자 지정 도메인 이름을 사용하려면 API 게이트웨이 엔드포인트를 가리키는 Route 53 별칭 레코드가 필요합니다.

REST API는 세 가지 엔드포인트 유형으로 배포할 수 있습니다. 엣지 최적화는 전 세계 배포를 위해 CloudFront 프런트엔드를 사용하며 기본값입니다. 리전은 CloudFront를 사용하지 않으므로 동일 리전의 클라이언트에 지연 시간이 더 짧거나 자체 CloudFront를 추가할 때 적합합니다. 프라이빗은 인터페이스 VPC 엔드포인트를 통해 VPC 내부에서만 액세스할 수 있으며 내부 마이크로서비스에 사용합니다. HTTP API는 엣지 최적화와 리전을 지원합니다. WebSocket API는 리전과 프라이빗을 지원합니다. 동일 리전에서 사용하는 API이거나 사용자 지정 CloudFront 배포를 이용할 때는 리전을 선택하십시오.

API 게이트웨이 REST API는 스테이지에서 카나리 배포를 지원합니다. 트래픽의 일정 비율을 카나리 배포(새 버전)로 보내고 나머지는 운영 배포로 보낼 수 있습니다. 카나리의 오류율과 지연 시간을 모니터링하고 안정적이면 트래픽을 100%로 늘리십시오. 문제가 발생하면 카나리 가중치를 0으로 설정하여 롤백할 수 있습니다. 이는 Lambda 별칭의 가중치 기반 라우팅과 유사하며 블루/그린 환경을 전환하지 않고도 API를 안전하고 점진적으로 업데이트할 수 있게 해 줍니다.

SAA-C03 시험에서 API 유형을 식별하는 핵심 표현은 다음과 같습니다. '비용 효율적인 단순 API' → HTTP API, '실시간 양방향' 또는 '서버 푸시' 또는 '채팅' → WebSocket API, '요청 변환', '사용량 계획', 'API 키 스로틀링', '응답 캐싱' → REST API입니다. 질문이 단순히 '저렴한 비용으로 Lambda를 HTTP 엔드포인트로 노출하라'는 내용이라면 HTTP API가 정답입니다. 복잡한 API 관리 기능이나 파트너가 관련된 질문이라면 일반적으로 REST API가 올바른 선택입니다.

이 레슨에서 다룬 AWS 솔루션스 아키텍트(SAA-C03) 개념에 대한 이해도를 확인해 보세요.

이 레슨에서는 다음을 배웠습니다. REST API는 캐싱, 변환, 사용량 계획, WAF를 포함한 API 게이트웨이의 전체 기능을 더 높은 비용으로 제공합니다. HTTP API는 기본 제공 JWT 인증과 더 짧은 지연 시간을 갖추고 REST API보다 70% 저렴하므로 고급 기능이 필요 없는 Lambda/HTTP 프록시 시나리오에 적합합니다. WebSocket API는 지속적인 연결을 통해 채팅, 게임, 실시간 데이터 애플리케이션에 서버 푸시 실시간 통신을 제공합니다. 다음으로 Lambda, HTTP 백엔드 및 모의 응답과 API 게이트웨이를 통합하는 방법을 살펴보겠습니다.