JSPM

swagger-combine-ui

0.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 6
  • Score
    100M100P100Q37137F
  • License MIT

Combines multiple Swagger schemas into one site

Package Exports

  • swagger-combine-ui

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (swagger-combine-ui) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Swagger Combine UI

Build Status

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

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.

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.

Docker

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