1
私はnpmモジュールを使用してapi-documentationをサーバと並列に設定していますので、devsがすべてのapiを追跡するのに役立ちます。私は、フォルダ構造を持っている何worknik用のapiをswaggerで一覧表示
は
/
/api
swagger/
swagger.json
swagger.yml
/swagger /*Having all the index file and configs as given their like public dir*/
私のミドルウエア構成は、この
var swagger = require('swagger-express');
app.use(swagger.init(app, {
apiVersion : '1.0',
swaggerVersion: '1.0',
swaggerURL : '/swagger',
swaggerJSON : 'api/swagger/swagger.json',
swaggerUI : './swagger/',
basePath : 'http://localhost:1222',
info : {
title : 'swagger-express sample app',
description: 'Swagger + Express = {swagger-express}'
},
apis : ['api/swagger/swagger.yml'],
middleware : function (req, res) {}
}));
私のサーバーはポート1222
で実行されているようです。 SwaggerUIは正常に読み込まれますが、読み込みAPIはwordnikのドメインから読み込まれます。
- 私は
swagger.yml
に言及していた場合はどのようにそれは私のswagger.yml
- からAPIを読んでいました、その後いただきました関連性と
swagger.json
- SwaggerUIに
discoverURL
何であるのでしょうか?私がjsonパス(http://localhost:1222/swagger/
)に言及していると、 'discoveryUrl basePathはURLでなければならない'のようなエラーで終了します。
私はサーバと並行してすべてのapiを一覧表示できますか?だからそれは同様にテストすることができますか?私は誇らしげにそれをしたい。
--saveインストールビジョンを不活性--save
NPMをインストールしてみてください? –