swagger-ui相关内容

招摇错误:冲突的schemaIds:检测到类型A和B的重复schemaIds

使用 Web API 并使用 swashbuckle 生成 swagger 文档,我在两个不同的命名空间中定义了两个具有相同名称的不同类.当我在浏览器中打开 swagger 页面时,它说 冲突的 schemaIds:检测到类型 A 和 B 的重复 schemaIds.请参阅配置设置 - “UseFullTypeNameInSchemaIds"以获取潜在的解决方法 完整信息: 50 ..
发布时间:2021-11-29 09:04:10 C#/.NET

Swashbuckle (Swagger) 中的默认模型示例

我正在运行 ASP WebAPI 2 并成功安装了 Swashbuckle.我想弄清楚如何定义默认架构值? 例如,在 Swagger 现场演示站点上,他们将 pet 的默认值更改为“doggie".他们还定义了状态的允许值.(现场演示) 解决方案 嗯,vgaspar.trivix 的代码对我来说没有完全工作,没有为架构设置默认值.我也得到了一个 NullPointerExceptio ..
发布时间:2021-11-29 09:03:29 其他开发

Swagger UI Web Api 文档 将枚举显示为字符串?

有没有办法将所有枚举显示为它们的字符串值,而不是它们的 int 值? 我希望能够提交 POST 操作并根据其字符串值放置枚举,而不必每次都查看枚举. 我尝试了 DescribeAllEnumsAsStrings 但服务器然后接收字符串而不是我们正在寻找的枚举值. 有人解决了吗? 编辑: 公开课信{[必需的]公共字符串内容{get;放;}[必需的][EnumDataType ..
发布时间:2021-11-29 08:58:58 C#/.NET

Swagger 没有为 IActionResult 包装的对象生成模型

使用以下代码,Swaggger UI 显示 RegistrationInfo 模型,但不显示 UserInfo 模型. 我如何让它生成? [Produces("application/json")][授权(AuthenticationSchemes = JwtBearerDefaults.AuthenticationScheme)][路由(“api")]公共类 UserController ..
发布时间:2021-11-24 17:42:08 C#

Swashbuckle 如何将 OneOf 声明添加到 OpenAPI 3

我有一个请求对象,它可以是 2 种字符串类型“A";或“B". 注意:这是我真正想要的一个更简单的例子.枚举在这里对我不起作用. 公共类 SampleRequest{//只能是“A"或“B"公共字符串 Property1 { 获取;放;}} 我正在尝试创建一个可以作为 OpenAPI“OneOf"输出的模式过滤器.属性. https:///datatracker.ietf.org/ ..
发布时间:2021-11-24 16:06:26 C#

.Net Core 3.1 在 Swagger UI 上删除架构

我有 .Net 3.1 Web Api,我想删除这部分“Schemas";在 Swagger UI 上. 怎么做? 解决方案 不需要架构过滤器.经过几天的努力,我发现: 所有需要做的事情都在 app.UseSwaggerUI(options =>{options.DefaultModelsExpandDepth(-1);}); 注意:它是 DefaultModels(复数)而不 ..
发布时间:2021-11-24 15:57:53 C#

在 SwaggerUI 中包含客户端 SDK 使用示例

我一直在寻找一种工具,它可以帮助我解析我的 JSON swagger 文件(甚至 YAML 文件)并基于 此示例 API 文档. 我已经试过了: codegen(所以我确实在 github 存储库中有代码示例,但我不知道如何在我的 UI 上动态获取它) slate,但我正在尝试继续大摇大摆 Widdershins 有人知道第三方工具能够产生这样的功能,还是我错过了 codeg ..
发布时间:2021-11-15 04:11:14 其他开发

关于 Swagger API 的建议

我正在使用 Java 8 构建一个使用 SpringBoot 和 Spring REST 服务的 API.我刚刚发现了 Swagger API,现在我想让我的 API Swagger 兼容. 据我所知,Swagger 是一种记录 APIS 的工具,而且还提供了从规范(v2 中的 swagger.json)生成客户端和服务器代码的功能,此外还有一个很好的 Web 界面来与您的 API 交互. ..
发布时间:2021-11-15 03:42:38 其他开发

使用 Swagger UI 设置 Api 版本

我有一个通过使用 Jersey 开发的 REST API,我们通过 swagger-ui 记录了 REST API.不幸的是,我们并没有从第一天开始对 API 进行版本控制.我们现在正在尝试向 API 添加版本控制. 我采取的第一步是尝试更新由动态生成的 swagger (html) 页面显示的 API 版本.我一直跟踪调用流程到 sw​​agger-ui.js 文件,但我无法弄清楚如何更改 ..
发布时间:2021-11-15 00:54:15 其他开发

每个控制器的 SpringFox Docket 在 Spring Boot 中不起作用

在我的 Spring Boot 应用程序中,我有多个 Rest 控制器,需要分别为每个控制器生成 swagger. 通过在我的 Spring Boot 应用程序类中为每个控制器使用以下 Docket 配置,我可以通过访问/v2/api-docs?group=ai 其中 i = 1 到 n 来下载控制器特定的 swagger但是在 swagger-ui.html 中,当我选择 a1(/v ..
发布时间:2021-11-15 00:52:50 其他开发

如何在 Swagger UI 中发送带有请求的自定义标头?

我在 API 中有一些端点 - /user/login、/products. 在 Swagger UI 中,我将 email 和 password 发布到 /user/login,作为响应,我收到了 令牌字符串. 然后,我可以从响应中复制令牌,并希望将其用作 Authorization 请求中的所有 url(如果存在)以及 /products 作为标头值一个例子. 我应该在 Sw ..
发布时间:2021-11-15 00:33:14 其他开发

Swashbuckle 如何将 OneOf 声明添加到 OpenAPI 3

我有一个请求对象,它可以是 2 种字符串类型“A";或“B". 注意:这是我真正想要的一个更简单的例子.枚举在这里对我不起作用. 公共类 SampleRequest{//只能是“A"或“B"公共字符串 Property1 { 获取;放;}} 我正在尝试创建一个可以作为 OpenAPI“OneOf"输出的模式过滤器.属性. https:///datatracker.ietf.org/ ..
发布时间:2021-10-26 15:58:41 其他开发

如何正确配置 ASP.NET Core 5 Swagger 以使用 Azure A/D 授权代码身份验证?

我正在将我的 ASP.NET Core 5 Web API 安全性从隐式升级到授权代码.身份验证是使用 Azure A/D 完成的,我还需要允许使用 Swagger 文档. 我已经设法让它工作了,但是 client_secret 在我的情况下没用,我想知道我是否做错了什么.我的配置如下: Azure A/D 重定向 URI:https://localhost:44444/swag ..
发布时间:2021-09-01 20:23:57 其他开发

如何访问 NGINX 代理背后的 FastAPI SwaggerUI 文档?

希望你能帮助我,这是我遇到的问题: 我的前端和后端服务器都运行在同一个 AWS EC2 实例上.因此,我创建了这样的 NGINX 配置: 服务器{服务器名称名称;听 80 default_server;地点/{proxy_pass http://127.0.0.1:5000;proxy_set_header 主机 $http_host;proxy_set_header X-Real-IP ..
发布时间:2021-09-01 20:23:51 其他开发

swagger-ui 3.0.6 - 添加自定义授权标头客户端(通过 javascript 下拉 onchange 事件)

我有兴趣了解如何使用 swagger-ui 3.0.6 将我的自定义授权标头自动添加到所有“试用"请求中. 在我的前端页面中,我有一个包含多个授权标头值的下拉列表.因此,我对 swagger 2.x 所做的是一个带有 onchange 事件的 javascript 函数,该函数将选定的 authorization header 值注入到 swaggerUI 实例中. 我无法使用 swagger ..
发布时间:2021-09-01 20:23:48 其他开发

在 Swagger UI 中呈现为空数组的对象数组

我在 OpenAPI/Swagger 规范中有以下模型定义: “定义":{“模型.设备":{"title": "设备",“类型":“对象",“特性": {“特征": {“类型":“数组",“项目": {"$ref": "#/definitions/models.Feature"}},“ID": {"类型": "整数",“格式":“int64"},“身份类型":{“类型":“字符串"},“姓名": ..
发布时间:2021-09-01 20:23:44 其他开发

如何更改 Swagger-ui URL?

我尝试更改 swagger URL,现在我有“http://localhost:8080/context-root/rest/swagger-ui.html", 我希望它是 "http://localhost:8080/swagger".我尝试使用 DOCKET.Host("swagger"),但浏览器正在旋转.它没有加载屏幕. io.springfox ..
发布时间:2021-09-01 20:23:38 其他开发