问题标签 [swagger-ui]

我刚刚将 Swagger 集成到我的 Play 应用程序中，它可以工作——http://localhost:9000/api-docs/返回 JSON 格式的 api 文档。

现在我想使用 Swagger-UI... 我已经按照 README 文件中的建议将发行版复制到myApp\public了，但没有办法让它工作——文档似乎有点过时了。

我试图将其添加到conf\routes...

...但它不起作用，我总是收到以下错误消息：

目录的内容public/swagger在这里。谢谢。

我能够使用Play设置Swagger并尝试 Swagger-ui ......我必须说它真的很棒。

ApiOperation用,等记录我的控制器的操作ApiImplicitPara很容易，并且可以按预期工作。

不过，由于我对 Swagger 的了解有限，在为 type 的隐式参数定义架构时遇到了问题body。我想映射到隐式参数的类如下所示：

我的模型类的内部表示是 JSON……然后我只提供读取/修改内部 JSON 的 getter 和 setter——这个解决方案让我可以非常快速地处理 JSON，并且我可以将对象按原样传递给 MongoDB。

问题是Swagger为上面的类生成的模型是这样的：

如何防止 Swagger 放入json模型？

我正在为我的休息服务使用 Swagger API 文档。我已经成功地将 Swagger 与我的代码集成并且它可以工作。

但我需要格式化 Swagger UI。由于我的项目中响应类的数量很多，所以 Swagger 页面看起来很长，用户必须向下滚动很多才能查看信息。

所以我想折叠我的响应模型类并在用户单击类时展开它。有没有办法做到这一点，如果有的话，必须在哪里进行哪些更改。我尝试编辑 Swagger-UI.js 文件，但无法获得所需的输出。

请让我知道并提前感谢。

我正在使用 Swagger-php 和 Swagger-UI，这一切都很好，但有一个烦恼。Swagger-UI 创建的 UI 具有我的 API 路由的预期点击展开部分，但每个部分的标题似乎是生成的 JSON 文件，而不是我可以给它的任何名称。在标题之后，描述是我在注释中给出的，但标题我似乎无法控制。

因此，如果我的路由以 /foo 的 resourcePath 开头，并且描述为“Foo API Functions”，则 UI 如下所示：

foo.json : Foo API 函数

我不想要“foo.json”，我更愿意指定它的含义。就像只是“Foo”甚至“Foo Functions”，然后将我的描述更改为更有意义的内容，例如“这是你找到 foo 函数的地方”。

我是否缺少为此使用的注释？

我可能会因为问这个问题而被击落：

我想将我的 API 中的端点标记为“新”或“更新”，这样当开发人员查看我的招摇 UI 时，他们可以看到所有最近添加的内容。

这样的事情存在吗？

反正有没有将版本号输入到招摇 UI 中？

所以我们可以让开发者知道每个部署的版本是什么？

我已经部署了Swagger UI (version swagger-ui-2.0.8) in tomcat. 这将定义一组 API，这些 API 调用部署在另一个域中的 Tibco BW 中的服务。到目前为止，一切都运行良好，但是当我们刚刚将 Tibco BW 服务实现为 SSL 时(uses **https**:xxxxxx:9090/user)。Swagger 发送 OPTIONS 请求，因为它部署在另一个域的 tomcat 中，(CORS request).我已将所有响应标头的 CORS 配置为“*”。

我们现在遇到的问题是来自 swagger 的 OPTIONS 请求没有身份验证标头来访问 BW 服务。如何实现这一点。请帮忙

提前致谢。

我一直在尝试使用最新版本的 SpringMVC 实现在这里设置 Swagger Spring-MVC 和 Swagger UI：Swagger Spring-MVC

我已经能够使初始设置正常工作，但是当我导航到我的 SwaggerUI 页面时，我收到一条错误消息，指出它无法访问我的 api，因为“服务器返回未定义”。当我查看萤火虫时，它说它正在获得 401 Unauthorized。

当您第一次导航到 SwaggerUI URL 时，会弹出一个对话框让我输入我的用户名和密码。我知道这是正确的，因为我可以手动使用具有相同凭据的资源。

我的假设是我让 Swagger 向它为自己生成的控制器添加了一些额外的授权形式。我尝试将其设置为基本身份验证，只是根本不设置身份验证，但这也不起作用。

有谁知道我的解决方案是什么？提前致谢。

是否有可用于为 Swagger 配置 spring boot+Jersey+JaxRs 应用程序的示例？

参考这篇文章，我的应用程序中有以下代码，无法调出招摇的 UI，也无法列出使用的资源

.

ApplicationInitializer 类：（Groovy）

资源：

[编辑]。我正在使用 Jersey 1.16，由于应用程序影响无法使用 Jersey 2

maven-3.0.5

我想在浏览器上访问 swagger 示例应用程序。我正在使用此链接（https://github.com/wordnik/swagger-core/tree/master/samples/java-jaxrs）遵循示例 swagger-core 的说明。

我已经从这个链接（https://github.com/wordnik/swagger-ui）克隆了 swagger ui 并放在 webapp 文件夹下。

如何在从 swagger-ui 在 url 上克隆的 web-app 文件夹中查看我的 index.html 文件？

每当我尝试访问一个网址时，它都会显示：

此 XML 文件似乎没有任何与之关联的样式信息。文档树如下所示。

我无法访问 swagger-ui。请帮我这样做。