Einrichten der Gateway-Antwortanpassung in OpenAPI

Mit der x-amazon-apigateway-gateway-responses-Erweiterung auf der API-Stammebene können Sie Gateway-Antworten in OpenAPI anpassen. Die folgende OpenAPI-Definition zeigt ein Beispiel für die Anpassung der GatewayResponse-Ressource vom Typ MISSING_AUTHENTICATION_TOKEN.

  "x-amazon-apigateway-gateway-responses": {
    "MISSING_AUTHENTICATION_TOKEN": {
      "statusCode": 404,
      "responseParameters": {
        "gatewayresponse.header.x-request-path": "method.input.params.petId",
        "gatewayresponse.header.x-request-query": "method.input.params.q",
        "gatewayresponse.header.Access-Control-Allow-Origin": "'a.b.c'",
        "gatewayresponse.header.x-request-header": "method.input.params.Accept"
      },
      "responseTemplates": {
        "application/json": "{\n     \"message\": $context.error.messageString,\n     \"type\":  \"$context.error.responseType\",\n     \"stage\":  \"$context.stage\",\n     \"resourcePath\":  \"$context.resourcePath\",\n     \"stageVariables.a\":  \"$stageVariables.a\",\n     \"statusCode\": \"'404'\"\n}"
      }
    }

In diesem Beispiel wird durch die Anpassung der Standardstatuscode 403 in 404 geändert. Außerdem werden der Gateway-Antwort vier Header-Parameter und eine Text-Mapping-Vorlage für den application/json-Medientyp hinzugefügt.