Add swagger api for server route about log-proxy-server

[inakianduaga]

http://strongloop.com/strongblog/enterprise-api-swagger-2-0-loopback/

[inakianduaga]

https://github.com/krakenjs/swaggerize-express
https://github.com/apigee-127/a127-documentation/wiki/What-is-Apigee-127

[inakianduaga]

UPDATE:

This has evolved and the official swagger node middleware is here

https://www.npmjs.com/package/swagger-express-middleware

[inakianduaga]

Update:

We do it manually since the swagger-node package is too opinionated and doesn't play nice with typescript

TODO:

• Get rid of swaggerize package, we do it ourselves
• Install swagger-ui npm package, this way we can always have latest version
• Move swagger ui registration to a separate swagger route
• Add a 301 redirection if the url is not set when serving the swagger route (copy from swaggerize-ui package)

  router.use(function (req, res, next) {
    if (!req.query.url) {
      var query = req.query;
      query.url = options.docs;
      return res.redirect(301, url.format({query: query}));
    }
    next();
  });