REST API

• CloudFormation resource AWS::ApiGateway::RestApi
• Regional service
• Edge-optimized
• Can be made private
• Integration types
  • AWS Use this to create AWS API proxies for virtually any service
  • AWS_PROXY lambda
  • HTTP_PROXY
  • HTTP
  • MOCK
• Offers caching

HTTP API

• CloudFormation resource AWS::ApiGatewayV2::Api
• Lightweight version of the REST API
• Regional service
• NOT Edge-optimized
• NOT Private
• Integration types
  • AWS_PROXY Lambda, SQS, Kinesis Data Stream, AppConfig, Step Functions, EventBridge with proper integration sub-types. Ref
  • HTTP_PROXY

WebSocket API

• Integration types
  • AWS
  • AWS_PROXY Lambda
  • HTTP_PROXY
  • HTTP
  • MOCK

Usage plan

Set throttling limits and send a 429 Too many requests HTTP response to clients

Throttling rule evaluation sequence -

1. Per client, per method limit set on a API stage
2. Per client limit on the API
3. Default per method limit or individual per method limit set on API stage
4. Per region account level limit

Error Note API gateway does not support HTTP endpoints, it is HTTPS only. Use CloudFront to add (http -> https) redirection.

FAQ

https://aws.amazon.com/api-gateway/faqs/