SwaggerでAPIを文書化しようとしています(とgem swagger-docs
)。私はいくつかの基本的な文書を完成させました。 Ran sudo SD_LOG_LEVEL=1 rake swagger:docs RAILS_ENV=production
エラーはありません。Swagger UIでJSONファイルが表示されない
私の問題は、Swagger UIがJSONにナビゲートする際にすべてのドキュメントを表示しないことです。私は個々のファイル/コントローラ(すなわち、users.json
)を見ることができますが、私がapi-docs.json
にアクセスすると、私は著作権や会社情報などを見ることができますが、APIは表示されません。
各コントローラのドキュメントは{root}/public/apis/v1/*.json
に書き込まれています。
スクリーンショット:闊歩で述べたあなたのベースパスを持ついくつかの不一致があるかもしれません
base_path: '/'; SwaggerはURL「http://192.168.33.7:31000/api/v1/api-docs.json'を探索します。プロジェクトのAPIコントローラの場所: 'web/app/controllers' –
ベースパスを" http://192.168.33.7:31000/ " –
にするか、アプリ全体に使用できる共通の設定ymlファイルがある場合は、 yml index.htmlのURLとベースパス –