Skip to content

hendrixroa/swagger-aws-api-gateway

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.