swaggerize-ui

swaggerize-ui is an node express middleware to show swagger-ui for your local (or external) api.

Installation

1npm install --save swaggerize-ui

Usage

1'use strict';
2
3var http      = require('http');
4var express   = require('express');
5var app       = express();
6var server    = http.createServer(app);
7var swaggerUi = require('swaggerize-ui');
8
9app.use('/api-docs', function (req, res) {
10  res.json(require('./path/to/swaggerize/docs.json'));
11});
12
13app.use('/docs', swaggerUi({
14  docs: '/api-docs' // from the express route above.
15}));
16
17server.listen(8000)
18  .on('listening', function () {
19
20  })
21  .on('error', function (err) {
22
23  });
24

Options

• docs - This is the path that gets put into to swagger-ui by default. You can do an absolute uri like above, or you can do a full url starting with http://. Default value is 'api-docs'.

• swaggerUiPath - This is the absolute path to whatever version of swagger-ui you would like to use. This should be to the dist/ folder within that project. Default value is the path to the swagger-ui module in this module's node_modules directory.

Questions

Hopefully this is simple enough to use to help make your swaggerized apis more consumable. If you do have any questions about how to use it, feel free to open up an issue, or a pull request.