Swagger UI不显示JSON文件

Question

我正在尝试使用Swagger记录API（在Rails中使用gem swagger-docs）。我有一些完整的基本文档。跑sudo SD_LOG_LEVEL=1 rake swagger:docs RAILS_ENV=production没有任何错误。

我的问题是Swagger UI在导航到JSON时没有显示我的所有文档。我可以查看单个文件/控制器（即users.json），但是当我访问api-docs.json时，我可以看到版权和公司信息等，但不能查看我的API。

每个控制器都将其文档写入{root}/public/apis/v1/*.json。

截图：

Answer 1

您可以在swagger文档中发布网址，例如基本路径和版本方法以及docs / index.html网址行，可能与swagger文档中提到的基本路径和生成的swagger文件存在一些不匹配