找不到 Golang 的 API 网关映射模板



我在 AWS API Gateway 上为 Twilio 创建了一个 webhook,它以application/x-www-form-urlencoded内容类型发送请求。我无法为 Golang 编写或找到映射模板。 我正在关注此文档 - 用于创建 API 网关的链接。我目前正在使用文档中使用的以下模板 -

我正在使用的 API 网关映射模板:

#set($httpPost = $input.path('$').split("&"))
{
#foreach( $kvPair in $httpPost )
#set($kvTokenised = $kvPair.split("="))
#if( $kvTokenised.size() > 1 )
"$kvTokenised[0]" : "$kvTokenised[1]"#if( $foreach.hasNext ),#end
#else
"$kvTokenised[0]" : ""#if( $foreach.hasNext ),#end
#end
#end
}

API 网关映射模板创建的 JSON:

{
"ToCountry": "US",
"ToState": "UT",
"SmsMessageSid": "SMed65aaxxxxxx5c7938df",
"NumMedia": "0",
"ToCity": "",
"FromZip": "",
"SmsSid": "SMed65aaxxxxxx938df",
"FromState": "",
"SmsStatus": "received",
"FromCity": "",
"Body": "Testing+again",
"FromCountry": "IN",
"To": "%2B1xxxxxx848",
"ToZip": "",
"NumSegments": "1",
"MessageSid": "SMed65aa5dxxxx7938df",
"AccountSid": "AC23xxxd98",
"From": "%2B9xxxxxx90",
"ApiVersion": "2010-04-01"
}

Lambda Code(Golang(

func Handler(request events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {
fmt.Printf("%+vn", request)
fmt.Println("request Body:", request.Body)
fmt.Println("request HTTPMethod:", request.HTTPMethod)
fmt.Println("request Headers:", request.Headers)
fmt.Println("request:", request.RequestContext.RequestID)
}

接口网关日志

(442f74ed-39e5-4372-bf85-42bf814f802f) Extended Request Id: EIaYxxMF3lQ=
(442f74ed-39e5-4372-bf85-42bf814f802f) Method request path: {}
(442f74ed-39e5-4372-bf85-42bf814f802f) Method request query string:    {}
(442f74ed-39e5-4372-bf85-42bf814f802f) Method request headers: {Accept=*/*, Cache-Control=max-age=259200, X-Twilio-Signature=ZWg2v7xxxfnBlPyxE=, User-Agent=TwilioProxy/1.1, X-Forwarded-Proto=https, I-Twilio-Idempotency-Token=e5d1xxx221bc4, X-Forwarded-For=54.xxxx.227, Host=xxxxxxx.execute-api.us-east-1.amazonaws.com, X-Forwarded-Port=443, X-Amzn-Trace-Id=Root=1-5de67103-7994dbxxx0dbd872, Content-Type=application/x-www-form-urlencoded}}  
(442f74ed-39e5-4372-bf85-42bf814f802f) Method request body before transformations: ToCountry=US&ToState=UT&SmsMessageSid=SMed65axxx595c7938df&NumMedia=0&ToCity=&FromZip=&SmsSid=SMed65aa5xxccdd595c7938df&FromState=&SmsStatus=received&FromCity=&Body=Good+Day&FromCountry=IN&To=%2Bxxxx848&ToZip=&NumSegments=1&MessageSid=SMed65axxxd595c7938df&AccountSid=AC23a2cbxxx65a66d98&From=%2B9xxxx5590&ApiVersion=2010-04-01
(442f74ed-39e5-4372-bf85-42bf814f802f) Endpoint request URI: https://lambda.us-east-1.amazonaws.com/2015-03-31/functions/arn:aws:lambda:us-east-1:6xxxxxxxx6:function:Twillio_connector_test/invocations
(442f74ed-39e5-4372-bf85-42bf814f802f) Endpoint request headers: {x-amzn-lambda-integration-tag=442f74ed-39e5-4372-bf85-42bf814f802f, Authorization=*****27aa7a, X-Amz-Date=20191203T142819Z, x-amzn-apigateway-api-id=xxxxx, X-Amz-Source-Arn=arn:aws:execute-api:us-east-1:69xxxx886:xxxxxxx/v1/POST/message, Accept=application/x-www-form-urlencoded, User-Agent=AmazonAPIGateway_f7504e7yc6, X-Amz-Security-Token=IQoJbxxxhQH [TRUNCATED]
(442f74ed-39e5-4372-bf85-42bf814f802f) Endpoint request body after transformations: 
{
"ToCountry": "US",
"ToState": "UT",
"SmsMessageSid": "SMed65aaxxxxxx5c7938df",
"NumMedia": "0",
"ToCity": "",
"FromZip": "",
"SmsSid": "SMed65aaxxxxxx938df",
"FromState": "",
"SmsStatus": "received",
"FromCity": "",
"Body": "Good+Day",
"FromCountry": "IN",
"To": "%2B1xxxxxx848",
"ToZip": "",
"NumSegments": "1",
"MessageSid": "SMed65aa5dxxxx7938df",
"AccountSid": "AC23xxxd98",
"From": "%2B9xxxxxx90",
"ApiVersion": "2010-04-01"
}
(442f74ed-39e5-4372-bf85-42bf814f802f) Endpoint response headers: {Date=Tue, 03 Dec 2019 14:28:20 GMT, Content-Type=application/json, Content-Length=43, Connection=keep-alive, x-amzn-RequestId=168394b7-c152-4434-af02-03a03b6f3090, x-amzn-Remapped-Content-Length=0, X-Amz-Executed-Version=$LATEST, X-Amzn-Trace-Id=root=1-5de67103-7994dbxxxxbe30dbd872;sampled=0}
(442f74ed-39e5-4372-bf85-42bf814f802f) Endpoint response body before transformations: "Lambda function is completed successfully"
(442f74ed-39e5-4372-bf85-42bf814f802f) Method response body after transformations: Lambda function is completed successfully
(442f74ed-39e5-4372-bf85-42bf814f802f) Method response headers: {X-Amzn-Trace-Id=Root=1-5de67103-7994dbxxxxxxd872;Sampled=0, Content-Type=application/xml}

Lambda 函数日志

request: {   map[] map[] map[] map[] map[] map[] {    {           }  map[]  } Good Day false}
{Resource: Path: HTTPMethod: Headers:map[] MultiValueHeaders:map[] QueryStringParameters:map[] MultiValueQueryStringParameters:map[] PathParameters:map[] StageVariables:map[] RequestContext:{AccountID: ResourceID: Stage: RequestID: Identity:{CognitoIdentityPoolID: AccountID: CognitoIdentityID: Caller: APIKey: AccessKey: SourceIP: CognitoAuthenticationType: CognitoAuthenticationProvider: UserArn: UserAgent: User:} ResourcePath: Authorizer:map[] HTTPMethod: APIID:} Body:Good Day IsBase64Encoded:false}
request Body: Good Day
request HTTPMethod: 
request Headers: map[]

在 Lambda 日志中,我可以看到只有创建的 JSON 正文映射到events.APIGatewayProxyRequest而不是其他参数。 原因是映射模板创建的 JSON 不是以下格式 -

The events.APIGatewayProxyRequest parameter in golang:
// APIGatewayProxyRequest contains data coming from the API Gateway proxy
type APIGatewayProxyRequest struct {
Resource                        string                        `json:"resource"` // The resource path defined in API Gateway
Path                            string                        `json:"path"`     // The url path for the caller
HTTPMethod                      string                        `json:"httpMethod"`
Headers                         map[string]string             `json:"headers"`
MultiValueHeaders               map[string][]string           `json:"multiValueHeaders"`
QueryStringParameters           map[string]string             `json:"queryStringParameters"`
MultiValueQueryStringParameters map[string][]string           `json:"multiValueQueryStringParameters"`
PathParameters                  map[string]string             `json:"pathParameters"`
StageVariables                  map[string]string             `json:"stageVariables"`
RequestContext                  APIGatewayProxyRequestContext `json:"requestContext"`
Body                            string                        `json:"body"`
IsBase64Encoded                 bool                          `json:"isBase64Encoded,omitempty"`
}

如果有人能指出我相关文件,我将不胜感激。欢迎提出建议。

看起来您可能正在尝试使用代理集成处理程序签名来处理特定资源上的 Lambda 自定义集成事件。我不认为映射模板与代理集成相关。

氧集成

有两种主要方法可以使用 Lambda 来响应 API 网关请求。第一种是使用 Lambda 集成。此方法通常涉及将请求转换为完全由您自行决定的自定义 Lambda 事件。大部分繁重的工作都是由 API 网关完成的。例如,您可以将查询参数转换为字符串,然后将该字符串仅提供给 Lambda 处理程序。

func handler(e string) (<something>, error) {}

或者,您可以从标头中获取一个值,从 URL 中获取一部分,然后构建一个 JSON 对象以馈送到您的处理程序。

type event struct {
URLPart string `json:"url_part"`
QueryPart string `json:"query_part"`
}
func handler(e *event) (<something>, error) {} 

大意

  • 您可以完全控制到达函数的请求事件
  • 您可以完全控制 Lambda 返回的响应
  • 更繁重的工作由 API 网关完成

代理集成

然后是代理集成。代理集成将发送到您在 API 网关中指定的资源(通常是 {proxy+} 资源上的 ANY 方法(的每个请求转换为事件。APIGatewayProxyRequest在事件模块中定义的结构类型。这样,您就无需将请求转换为必须指定的特定事件,并消除了 API 网关中繁重的请求工作,并将其放入 Lambda 处理程序中。

代理集成处理程序必须具有以下签名:

func handler(c context.Context, e events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {}

大意

  • 请求和响应始终相同,事件。APIGatewayProxyRequest and events.APIGatewayProxyResponse
  • 在 API 网关中需要完成的工作要少得多
  • 通常在您已经在 Golang 解决方案上投入大量资金并且不想将其分解为 Lambda 集成的单个资源部分时使用。

这是一个链接,解释了更多差异以及每个差异的一些注意事项。

最新更新