Example of how to generate Swagger UI based on multiple YAML files. There are two schema files:

1. openapi.yml => the main yaml file to define Open API
2. entities.yml => file to store entities schema referenced by openapi.yml

Tools used:

• Express
• Swagger UI Express
• JSON Schema Ref Parser

Install

npm install

Run

npm start

Then open URL http://localhost:3100/api-docs