swaggerql/swagger-combine-ui

Combines multiple Swagger schemas into one site

Swagger Combine UI

The service is used to combine the documentation of various services and display it.

When you should use swagger-combine-ui:

• You have a certain number of microservices and you need to combine their Swagger into one interface

Usage

Checkout this repository locally, then:

npm i
npm start

Now you can visit http://localhost:3000 to view your server.

Docker

Run swagger-combine-ui with a custom config file:

docker run -d -p 3000:3000 -v /path/to/swagger.yaml:/app/swagger.yaml swaggerql/swagger-combine-ui

Configuration

The default path for the configuration file is ./swagger.yaml

Swagger Combine UI requires one configuration schema which resembles a standard Swagger schema except for an additional apis field.

For informations about configuration have a look at the documentation of swagger-combine.

Configuration example

swagger.yaml

swagger: '2.0'
info:
  title: Basic Swagger Combine Example
  version: 1.0.0
apis:
- url: http://petstore.swagger.io/v2/swagger.json
- url: https://api.apis.guru/v2/specs/medium.com/1.0.0/swagger.json
- url: https://api.apis.guru/v2/specs/deutschebahn.com/betriebsstellen/v1/swagger.json
  paths:
    base: /bahn

APIs difference

url field

URL or query path to swagger apidocs. If the url field contains a path, then the full url is formed from the request headers:

• Host header is used as the domain.
• X-Forwarded-Proto header is used as a schema. Schema is http by default.

License

MIT

swagger-combine-ui's Issues

Support openapi3

https://github.com/LucyBot-Inc/api-spec-converter