swagger-ui相关内容

每个控制器的 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 ..

如何在 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 ..

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 其他开发

在运行时更改 swagger-ui 服务器变量

使用 openapi v3 配置,我有一个名为“主机名"的服务器变量,用于构建 url,例如: ...服务器:- 网址:http://{主机名}/api变量:主机名:"default": "这里有一些默认值".... 在运行时,我希望能够更改“主机名"服务器变量.我在页面上找到了 UI 元素, 通过编辑输入字段更改变量工作正常,但通过 jQuery 更改输入字段不起作用,即使在设置值后触 ..
发布时间:2021-09-01 20:23:32 其他开发

使用 Swashbuckle.AspNetCore 为 Swagger UI 设置 syntaxHighlight 属性

我正在为一个项目使用 Swashbuckle.AspNetCore.我开始使用的版本是5.5.1,在渲染大体(20k json 行)的结果时,速度非常合理(数据获取需要 50 毫秒,渲染时间不到一秒.当我升级到 5.6.x,语法现在突出显示(看起来不错),但将这些结果的呈现速度减慢到 20 秒以上.一旦呈现,页面上导致刷新的任何操作都需要20 秒,直到结果被清除. 在通常的搜索之后,我想尝试 ..
发布时间:2021-09-01 20:23:29 其他开发

我可以让 swagger-php 在查询字符串上使用数组吗?

我使用 Swagger-php.当我在查询字符串上定义一个参数时,它可以是一个数组.但据我所知,它不支持这种查询字符串: https://api.domain.tld/v1/objects?q[]=1&q[]=5&q[]=12 如果可能的话,我相信这会在collectionFormat字段中设置.目前我一直在使用 pipes,但我想使用上述格式,并且 Swagger-UI 也反映了这一点.但是 ..
发布时间:2021-09-01 20:23:25 PHP

配置 Swagger-UI 以获取 Spring 的 HttpSecurity Logout 端点

我已经为我的应用程序中列出的所有控制器设置了 Swagger 并为其工作.但是,我希望它选择 Spring Security Logout Endpoint,但我找不到让它工作的方法.正如您从下面的代码片段中看到的,我正在为用户指定一个 logoutUrl 以使他们的会话无效.我已经尝试过类级别的注释标记和方法级别,但没有运气.有什么想法吗? @Override公共无效配置(HttpSecuri ..
发布时间:2021-09-01 20:23:23 Java开发

反向代理背后的 Springfox Swagger UI

我已经使用 Swagger API 文档配置了一个 Spring Boot 应用程序并配置了 Swagger UI. 我还在一个反向代理后面运行我的后端应用程序,该代理将所有请求从 host:port/api 映射到 backend_host:port/,当在我映射的本地主机上运行时localhost:8082/api.在生产中应用了类似的映射. 当我从 localhost:8082/ ..
发布时间:2021-09-01 20:23:17 其他开发

Swashbuckle Swagger UI:如何从 xml 注释中的参数中删除必需的

我想更改控制器中某些参数的必需属性.我使用 XML 注释来链接到 Swagger. 解决方案 在继续之前,请仔细考虑您的参数.该参数是否真的需要,您的输入是否反映了这一点?是否有一个合理的默认值,在这种情况下预期的行为是什么?根据您的回答,您可能更喜欢以下两种解决方案之一: 选项 1:可选参数 如果 accessTokenID 具有合理的默认值,您可以在 API 签名上指定该值 ..
发布时间:2021-09-01 20:23:12 C#/.NET

告诉 swaggerui 主人在哪里的最佳方式

当我构建 swagger.json 文件时,我不知道要使用哪个主机.但是,当我的承载 swaggerui 的页面加载时,我可以解决这个问题(实际上我可能想为用户提供一个选择).我希望在 swaggerUI 对象的配置中看到 options.host - 我没有看到.是否有我无法找到的现有方法,或者我是否只需要修改代码并添加此功能(欢迎指向最佳位置的指针) 解决方案 两种方式 修改 s ..
发布时间:2021-09-01 20:23:09 其他开发