如何从Swagger+API Gateway扩展JSON识别Lambda非代理集成端点？

嘿，不用头疼手动逐个检查UI！你完全可以通过分析导出的Swagger + API Gateway Extensions JSON文件，快速定位Lambda非代理集成的端点，下面给你详细说怎么弄：

核心思路是区分两种集成在Swagger配置里的特征，先排除代理集成，剩下的就是非代理的：

1. 先明确Lambda代理集成的特征（用来排除） #

Lambda代理集成在JSON里有非常明确的标识，你可以先把这些端点过滤掉：

• 每个端点的x-amazon-apigateway-integration字段中，type的值是aws_proxy
• 通常会带有passthroughBehavior字段（常见值是WHEN_NO_MATCH）
• requestTemplates一般只有application/json，且模板内容是{"body": "$input.json('$')"}这种极简的透传模板

2. 定位Lambda非代理集成的端点 #

非代理集成的配置和代理的差异很大，你可以通过这些特征识别：

• x-amazon-apigateway-integration的type值是aws（注意不是aws_proxy）
• 包含uri字段，格式为arn:aws:apigateway:<region>:lambda:path/2015-03-31/functions/<lambda-function-arn>/invocations，明确指向Lambda函数
• 会有自定义的requestTemplates，比如针对不同Content-Type设置不同的参数映射模板（把API请求的参数、body等转成Lambda需要的输入结构）
• 可能带有requestParameters字段，用来映射API Gateway的请求参数到Lambda的输入参数
• 通常会有responses字段，定义不同状态码对应的响应映射规则

3. 用脚本批量筛选（高效不费力） #

如果你的API数量较多，写个简单的脚本自动遍历JSON文件会更高效，比如用Python写个小工具：

import json

# 加载导出的Swagger JSON文件
with open('your-api-export.json', 'r') as file:
    api_config = json.load(file)

print("Lambda非代理集成的端点列表：")
# 遍历所有路径和HTTP方法
for path, method_configs in api_config['paths'].items():
    for http_method, details in method_configs.items():
        integration = details.get('x-amazon-apigateway-integration', {})
        # 判断是否为Lambda非代理集成
        if integration.get('type') == 'aws' and 'lambda' in integration.get('uri', ''):
            print(f"- {http_method.upper()} {path}")

运行这个脚本后，就能直接得到所有非代理集成的端点列表，不用再一个个去UI里找了。

最后验证 #

筛选完成后，你可以抽几个端点在API Gateway UI里核对一下，确保识别准确，之后就可以放心地批量迁移这些端点到Lambda代理集成了。

内容的提问来源于stack exchange，提问作者bijalscm