swagger-ui-middleware

Swagger UI hosting middleware for ExpressJS

Installation

Install swagger-ui in preferable version first:

npm install swagger-ui --save

then install swagger-ui-middleware:

npm install swagger-ui-middleware --save

in your ExpressJS application:

var swaggerUiMiddleware = require('swagger-ui-middleware');
swaggerUiMiddleware.hostUI(app);

swagger-ui is being hoted under api-doc, for example: localhost:8080/api-doc and hosts ./node_modules/swagger-ui/dist content.

Configuration

swagger-ui-middleware can be configured as follow:

var swaggerUiMiddleware = require('swagger-ui-middleware');
swaggerUiMiddleware.hostUI(app, {path: '/test', overrides: __dirname+'/swagger-ui'});

path

default: /api-doc

Context resource that hosts swagger-ui

overrides

default: undefined

Directory which contains overriding resources lke index.html which can be adjusted

source

default: __dirname + '/../swagger-ui/dist'

Source folder which indicates swagger-ui resources.

Example

Full example can be found in example deirectory.

var port = process.env.PORT || 8081;
var express = require('express');
var app = express();
 
var swaggerUiMiddleware = require('swagger-ui-middleware');
swaggerUiMiddleware.hostUI(app, {path: '/test', overrides: __dirname+'/swagger-ui'});
    
 
app.listen(port);
console.log('App started on port ' + port);

To run example:

node examples/petstore/server

Tests

To run tests via Grunt:

grunt test

or in watch mode:

grunt testing

to run testing app:

node test/fixtures/server