Skip to content

A-EYE-Team/swagger-docs

 
 

Repository files navigation

Swagger Docs

Swagger API Documentations Viewer

Build Status

Warning! Under development

This project is under development and not ready for production use.

Features

✔ Customizable

It's very easy to customize the looks of Swagger Docs.

✔ Linkable

Each path, operation, parameter and many more elements have their own URL.

✔ Independent from Swagger specs

Swagger Docs can load Swagger specs dynamically. Updating your API documentation is as easy as updating your Swagger specs file (swagger.json).

✔ Templates

You can use templates in description sections or other places to have custom variables for each user. For example you can have user access_token in documentations.

✔ Mobile Ready

Documentations look as good in mobile devices.

Usage

Serve static files

Swagger Docs is a static web application. You can download it via npm and serve the dist folder in your web server. Swagger Docs will make a request to ./swagger.json to get the Swagger document to render.

npm install swagger-docs

Use the Connect middle-ware

If you are using Express or any other Connect based server, there is a connect middle-ware.

var SwaggerDocs = require('swagger-docs');
var swagger = require('path/to/swagger.json');

app.use(SwaggerDocs.middleWare(swagger, {path: '/api-documentations'}));

Configuring Swagger Docs

Read Configuration Documentations here

Development

Read Development Documentations here.

License

MIT

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 70.7%
  • HTML 20.6%
  • CSS 8.7%