问题标签 [swagger]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
0 回答
192 浏览

django - sweetpie swagger 是否具有内置身份验证?

有没有办法让大摇大摆地使用login_required装饰器?我有几个观点:

有没有办法让我也可以大摇大摆地使用它?它会自动将用户重定向到登录页面,并且很方便。

0 投票
1 回答
389 浏览

c# - ServiceStack + Swagger 以不同方式对资源进行分组的能力

首先让我说 ServiceStack 作为一个框架已经超出了我的所有期望。所取得的成就令人惊叹。

我目前正在使用带有 ServiceStack 的 Swagger UI 插件,并且想知道有没有一种方法可以将资源单独分组而不是现在出现的?似乎分组是由根决定的。

当前的分组是这样的:

我宁愿让 swagger ui 输出如下所示的内容:

如果您可以通过使用如下所示的分组来执行如上所示的操作,那就太酷了。

这可能更多是 Swagger 的限制,而不是 ServiceStack 的限制,但我想我会问。

0 投票
3 回答
688 浏览

tastypie - django-tastypie-swagger not serving Swagger's JS/CSS files

I have a fresh install of django-tastypie and django-tastypie-swagger.

http://localhost:8000/tasty/doc/ serves the necessary HTML, but doesn't pull in any of the CSS or JS that's needed to make it work.

http://localhost:8000/tasty/doc/resources/ works and shows:

But all the others (/schema/ and the static files) return 404 errors.

0 投票
2 回答
129 浏览

java - 宇宙飞船java问题gui

这段代码给了我多个错误,而这个类是我用来创建一个用 Java 发射激光的宇宙飞船的 3 个类之一。有什么问题,为什么不能编译?我真的迷路了。谢谢!

0 投票
1 回答
2331 浏览

guice - Swagger 和 Google Guice 设置

我正在尝试向我的项目添加招摇。我们的设置与示例项目略有不同。我们使用 guice 和 guice-servlet 来注入并启动我们的 JerseyServletModule。

今天我们的 web.xml 看起来像这样

MyServletModule 类看起来像

我应该在哪里以及如何添加招摇?

0 投票
3 回答
32957 浏览

javascript - 如何让 Swagger 将 API 密钥作为 http 而不是在 URL 中发送

我将 swagger 与servicestack一起使用,但我从我的 /resources URL 收到 401 未经授权的错误,因为它需要 API 密钥。

除非我弄错了,否则根据文档,在从我的 html 页面初始化 Swagger 时,我应该将supportHeaderParams以及JSON 参数中的apiKeyNameapiKey值设置为 true 。

然后我希望在 http 请求标头中看到我的 API 密钥,但它仍然被附加到 URL 而不是标头集合中。

这是在我的 HTML 页面中初始化 Swagger 的代码:

不幸的是,我根本没有得到任何标题,没有“Api-Key”或“testheader”。

0 投票
1 回答
2432 浏览

java - 将多个注释合并为一个以避免重复

我正在使用 Spring MVC 实现各种 REST 服务。对于文档,我使用的是 Swagger。

这很好用,文档看起来不错,而且非常实用。我唯一的问题是文档注释确实挤满了控制器类,尤其是错误代码注释。

例子:

在许多情况下,这会导致大量注释,其中真正的应用程序代码隐藏在两者之间。此外,这些注释集经常重复,因为许多方法可能返回相同的错误代码集。

是否有任何选项可以通过在其他地方将注释列表定义为另一个类文件中的常量来缩短这一点?或者也许我可能忽略了更简单的事情?

我尝试在@ApiError某处定义项目数组,但这不会编译:

如果有人能给我提示如何解决这个问题,我会很高兴,在此先感谢!

0 投票
1 回答
2138 浏览

c# - ASP.NET Web API 文档重复条目

我正在尝试为我的 API 创建文档。到目前为止,我已经尝试过使用Swagger.NetWeb API 帮助页面

这两个工具都为我提供了从 XML 生成的正确文档,但它们都向我显示了重复的条目。我想这与我的路线配置方式有关:

我看到的是来自 Sample1 和 Sample2 的方法,如下所示:

我想要这个:

有任何想法吗?

0 投票
3 回答
21195 浏览

wcf - 将 Swagger 与 WCF REST 一起使用

我有一个基于 WCF REST 的服务,我想将 Swagger 添加到其中。我已经安装了 Swagger.NET 包,我的项目使用的是 .NET 4.0。我还启用了 XML 文档等……但现在我不确定从这里出发的最佳路线。

当我启动时http://localhost/SwaggerUI/index.html,我得到带有http://YOUR-URL-HERE:PORT/api/swagger. 我不确定这里应该放什么网址。我确实通过以下方式启用了服务帮助:<standardEndpoint name="" helpEnabled="true" />这确实给了我丑陋的页面: http://localhost/api/help-当我将其插入 Swagger 时,我得到了结果:

最好的方法是什么,我没有使用 WebApi,但如果有帮助的话,有很多可用的功能。

0 投票
0 回答
652 浏览

json - 生成占位符抽象类的扩展类json模式

Swagger 生成的 Json 模式面临一些问题。

我有一个抽象类类型的基类。两个类扩展了这个基类。并且主传输对象对象包含抽象类字段,因此它将充当两种扩展类的通用占位符

我可以通过使用 Jackson 注释来实现这一点。但 Swagger 尊重杰克逊的注释。

使用杰克逊:

Swagger 只是说,需要传递类型基类的对象,但我希望 swagger 用扩展类的详细信息构造 json 模式并显示它。

Swagger json 架构如下所示:

但我也想大摇大摆地扩展扩展类。

有什么办法可以让我大摇大摆地使用杰克逊注释吗?