swagger-aws-api-gateway

Module to add aws api gateway integration to a swagger file

Usage no npm install needed!

<script type="module">
  import swaggerAwsApiGateway from 'https://cdn.skypack.dev/swagger-aws-api-gateway';
</script>

README

Swagger AWS API Gateway

Small library to add AWS API Gateway integration to your swagger/openapi specification. Boring to have dealing with API Gateway integrations like x-amazon-apigateway-integration (see AWS docs API GW Integration) on your swagger file specification?, this small package is for you 😉.

How to install

npm i swagger-aws-api-gateway # or
yarn add swagger-aws-api-gateway

How to use

const awsIntegration = require('swagger-aws-api-gateway');
const swaggerJSONData = {}; // your swagger valid json data;
const swaggerWithIntegrations = awsIntegration.addIntegration(swaggerJSONData);
console.log('Result: ', swaggerWithIntegrations);

Limitations

  • This library is thinking only for API Rest with VPC link integrations and port mappings deployment running on AWS ECS/EC2/K8, check more here API GW VPC Link integration
  • When you creates the API Gateway deployment you should to add this environment variables:
vpcLinkId -> Vpc link id
nlbDnsName -> Dns name of load balancer provisioned
port       -> Api port of you service running

- This module (For now) is not validating if a swagger spec has the right format, please be aware of that.