用途：为使用 Amazon API Gateway 构建、管理、治理和运维 API 提供专家级指引，覆盖 REST API（v1）、HTTP API（v2）和 WebSocket API。
主要能力：先做 API 类型选型——REST API 面向企业级 API 管理，支持用量计划与按消费者限流配额、API 密钥、请求校验、WAF、资源策略、缓存、金丝雀发布、私有端点；HTTP API 是低成本轻量代理，成本约低 70%、延迟更低，但不含上述管理能力；WebSocket API 用于实时双向通信。还涵盖端点类型（边缘优化、区域、私有）、拓扑、认证（Lambda/JWT/Cognito 授权方）、mTLS、自定义域名与路由、服务集成、SAM/CloudFormation 模板、限流与缓存、日志与指标、部署与治理。
使用方式：回答前先阅读相关参考文件，不依赖摘要；跨领域任务需读全部相关参考；需要 IaC 时查阅 references/sam-cloudformation.md 或 references/sam-service-integrations.md 并提供完整可用的 SAM/CloudFormation YAML。IaC 默认使用 CDK TypeScript，可用“use SAM”“use CloudFormation”“use Terraform”覆盖。回答结构为：建议、代码、陷阱、限制。
适用场景：外部消费者、合作伙伴或多租户平台 API；需要按消费者限流配额、请求校验、缓存或 API 层 WAF；需要私有端点、资源策略或金丝雀发布；轻量代理与原生 JWT 授权；聊天、通知、实时看板等 WebSocket 场景。
限制：REST API 默认超时 29 秒（区域/私有端点可申请提升至 300 秒）；HTTP API 硬超时 30 秒；/ping 与 /sping 为保留路径；执行日志事件截断于 1024 字节；413 无法自定义网关响应；REST API 请求校验不校验 maxItems/minItems；OpenAPI 根级安全被忽略；JWT 授权方公钥缓存 2 小时；管理 API 限流 10 rps/40 burst；REST API 配置变更后必须重新部署；边缘优化端点不在边缘缓存。具体配额与价格以 AWS 最新官方页面为准。