api-gateway

1# AWS API Gateway
2 
3Amazon API Gateway is a fully managed service for creating, publishing, and securing APIs at any scale. Supports REST APIs, HTTP APIs, and WebSocket APIs.
4 
5## Table of Contents
6 
7- [Core Concepts](#core-concepts)
8- [Common Patterns](#common-patterns)
9- [CLI Reference](#cli-reference)
10- [Best Practices](#best-practices)
11- [Troubleshooting](#troubleshooting)
12- [References](#references)
13 
14## Core Concepts
15 
16### API Types
17 
18| Type | Description | Use Case |
19|------|-------------|----------|
20| **HTTP API** | Low-latency, cost-effective | Simple APIs, Lambda proxy |
21| **REST API** | Full-featured, more control | Complex APIs, transformation |
22| **WebSocket API** | Bidirectional communication | Real-time apps, chat |
23 
24### Key Components
25 
26- **Resources**: URL paths (/users, /orders/{id})
27- **Methods**: HTTP verbs (GET, POST, PUT, DELETE)
28- **Integrations**: Backend connections (Lambda, HTTP, AWS services)
29- **Stages**: Deployment environments (dev, prod)
30 
31### Integration Types
32 
33| Type | Description |
34|------|-------------|
35| **Lambda Proxy** | Pass-through to Lambda (recommended) |
36| **Lambda Custom** | Transform request/response |
37| **HTTP Proxy** | Pass-through to HTTP endpoint |
38| **AWS Service** | Direct integration with AWS services |
39| **Mock** | Return static response |
40 
41## Common Patterns
42 
43### Create HTTP API with Lambda
44 
45**AWS CLI:**
46 
47```bash
48# Create HTTP API
49aws apigatewayv2 create-api \
50  --name my-api \
51  --protocol-type HTTP \
52…