Я использовал проект swagger create для поддержки API для обслуживания узлов. Я следовал these instructions. Я также использую инструменты swagger для обслуживания swagger-ui.Изменить basePath for swagger-ui
Я хотел бы динамически изменить basePath API и его документацию с '/' и '/ docs' на routingPath и routingPath + '/ docs.
Я могу изменить basePath моей спецификации API swagger, но я не уверен, как изменить basePath swagger-ui. Мой код выглядит следующим образом:
'use strict';
const defaultRoutingPath = '/api/collection';
const defaultPort = 3000;
var path = require('path');
var SwaggerExpress = require('swagger-express-mw');
var SwaggerUi = require('swagger-tools/middleware/swagger-ui');
var app = require('express')();
module.exports = app; // for testing
var routingPath = process.env.ROUTING_PATH || defaultRoutingPath;
var config = {
appRoot: __dirname // required config
};
SwaggerExpress.create(config, function(err, swaggerExpress) {
if (err) { throw err; }
swaggerExpress.runner.swagger.basePath = routingPath; // this works
app.get('/', (req, res) => {
res.redirect(path.join(routingPath, 'docs'));
})
// enable SwaggerUI
app.use(swaggerExpress.runner.swaggerTools.swaggerUi({
basePath: routingPath // this has no effect
}));
// install middleware
swaggerExpress.register(app);
var port = process.env.PORT || defaultPort;
app.listen(port);
if (swaggerExpress.runner.swagger.paths['/hello']) {
console.log('try this:\ncurl http://127.0.0.1:' + port + path.join(routingPath, '/hello?name=Scott'));
}
});
Если я запускаю эту услугу, я найти свой API спецификации на http://localhost:3000/api/collection
И мою страницу DOCS на http://localhost:3000/docs
Я хотел бы служить документы page at http://localhost:3000/api/collection/docs
Я попытался сделать это, передав параметр basePath в конструктор swaggerUi.
// enable SwaggerUI
app.use(swaggerExpress.runner.swaggerTools.swaggerUi({
basePath: routingPath // this has no effect
}));
Это не сработало. Кто-нибудь знает, как настроить basePath для swagger-ui?