@cdk-construct/api-gateway

Environment-aware API Gateway REST API constructs for AWS CDK.

Overview

This package provides explicit REST API constructs for private and regional API Gateway deployments. Both variants include CloudWatch access logs, X-Ray tracing, execution metrics, IAM authorization defaults, a Lambda {proxy+} integration, and environment-aware log retention.

Use PrivateApiGatewayRestApi when traffic should stay behind API Gateway VPC endpoints. Use RegionalApiGatewayRestApi when the API should be reachable as a regional API. ApiGatewayVpcEndpoint creates the interface endpoint and security group foundation for private APIs.

The constructs intentionally create a single greedy proxy route. Application routes should be owned by the Lambda framework, such as FastAPI or a TypeScript HTTP framework, rather than modeled as API Gateway resources in CDK.

See docs/rest-api.md for configuration and stack usage examples.