Spring REST/Swagger/Postman - 正在下载的损坏/空白文件
我关注了 这篇 帖子的功能:客户端现在可以下载文件(即 csv、pdf 和 zip). 但是我得到的是空白的 pdf，或者在尝试使用 zip 文件时，它会损坏.只有 CSV 可以正常工作. 我检查了标题，一切似乎都符合标准.我什至没有使用“application/octet-stream"，而是将“application/pdf"用于 pdf，“application/csv"用于 c
..
swagger-ui相关内容
WSO2 与 Docker 不兼容
我必须关闭 wso2server 才能在同一台机器上测试其他 API 管理工具.另一个工具提供了在 Docker 上运行的快速设置，所以我必须安装 docker. 现在，当我关闭每个 docker 服务并再次启动 wso2server 时，看起来有些服务检测到 docker 虚拟接口 IP (172.17.0.1) 而不是使用真实 IP (10.22.106.101): [2016-11-
..
通过属性版本控制在 Swagger 中利用 MultipleApiVersions
在使用属性路由时是否可以在 Swagger UI/Swashbuckle 中利用 MultipleApiVersions? 具体来说，我通过以下方式实现版本控制: 使用 System.Web.Http;命名空间 RESTServices.Controllers.v1{[路线("api/v1/Test")]公共类 TestV1Controller : ApiController{ ... }
..
Swagger 中的 Keycloak 集成
我有一个受 Keycloak 保护的后端，我想通过 swagger-ui 访问它.Keycloak 提供了 oauth2 隐式和访问代码流，但我无法使其工作.目前，Keycloak 的文档缺乏关于 swagger.json 中的 authorizationUrl 和 tokenUrl 应该使用哪个 url 的文档. Keycloak 中的每个领域都通过访问 提供了大量的配置 URL 列表ht
..
swagger-ui 部署后返回 500
开箱即用的配置在我的机器上完美运行，完全没有问题. 但是当我部署到我们的测试环境时 - 我收到以下消息 500 : { "Message": "发生错误."}/api/swagger/docs/v1
..
Web Api 如何在 Swagger 中为所有 API 添加 Header 参数
我搜索了添加请求标头参数的可能方法，该参数会自动添加到我的 web-api 中的每个方法，但我找不到明确的方法. 在搜索时，我发现方法 OperationFilter() 必须对此做些什么. 解决方案 是的，你可以通过继承 IOOperationFilter 您可以在 GitHub 上找到答案:AddRequiredHeaderParameter > using System
..
从 Swagger API 文档生成 PDF
我使用 Swagger UI 来显示我的 REST 网络服务并将其托管在服务器上. 然而，Swagger 的这项服务只能在特定的服务器上访问.如果我想离线工作，有人知道如何使用 Swagger UI 创建静态 PDF 并使用它吗?此外，PDF 很容易与无法访问服务器的人共享. 非常感谢！ 解决方案 我想出了一个方法，使用 https://github.com/springfox
..
Swagger (Asp.Net Core) 是否有控制器描述?
我正在构建一个将托管多个控制器(微服务)的 REST 服务.总的来说，让我们称服务为“Bob".所以 swagger 显示“Bob"/“Bob 微服务的集合".然后列出控制器名称.现在，它只显示 XYZ、ABC 等.有没有办法可以大摇大摆地显示“XYZ - XYZ API 的集合"或类似的东西? 似乎 swagger 在方法上显示了///Summary，但在控制器上没有显示. 解决方案
..
使用授权标头 (Bearer) 设置 Swagger (ASP.NET Core)
我有一个 Web API (ASP.NET Core)，我正在尝试调整 swagger 以从它进行调用.调用必须包含 Authorization 标头，并且我正在使用 Bearer 身份验证.来自 Postman 等第三方应用程序的调用正常.但是我在为 swagger 设置标题时遇到了问题(由于某种原因，我没有收到标题).这是现在的样子: "host": "localhost:50352","
..
Swagger UI 将身份验证令牌传递给标头中的 API 调用
我是 Swagger 的新手. 我正在使用 Swagger UI 生成 swagger 文档.我有两个 API 调用.第一个调用是根据用户名和密码生成令牌.第二次调用需要第一次调用生成的令牌. 我如何使用 Swagger UI 为第二次调用设置该令牌? 解决方案 @ApiImplicitParams 和 @ApiImplicitParam 应该可以解决问题: @GET@Pro
..
如何更改 Swagger-ui URL 前缀?
我使用 Springfox Swagger2 和 Spring boot 1.5.9. 我可以通过此链接访问 swagger UI. http://localhost:8090/swagger-ui.html 如何将其更改为在以下 URL 上可用? http://localhost:8090/my/custom/path/swagger-ui.html @EnableSw
..
招摇错误:冲突的schemaIds:检测到类型A和B的重复schemaIds
使用 Web API 并使用 swashbuckle 生成 swagger 文档，我在两个不同的命名空间中定义了两个具有相同名称的不同类.当我在浏览器中打开 swagger 页面时，它说 冲突的 schemaIds:检测到类型 A 和 B 的重复 schemaIds.请参阅配置设置 - “UseFullTypeNameInSchemaIds"以获取潜在的解决方法 完整信息: 50
..
Swashbuckle (Swagger) 中的默认模型示例
我正在运行 ASP WebAPI 2 并成功安装了 Swashbuckle.我想弄清楚如何定义默认架构值? 例如，在 Swagger 现场演示站点上，他们将 pet 的默认值更改为“doggie".他们还定义了状态的允许值.(现场演示) 解决方案 嗯，vgaspar.trivix 的代码对我来说没有完全工作，没有为架构设置默认值.我也得到了一个 NullPointerExceptio
..
Swagger UI Web Api 文档 将枚举显示为字符串?
有没有办法将所有枚举显示为它们的字符串值，而不是它们的 int 值? 我希望能够提交 POST 操作并根据其字符串值放置枚举，而不必每次都查看枚举. 我尝试了 DescribeAllEnumsAsStrings 但服务器然后接收字符串而不是我们正在寻找的枚举值. 有人解决了吗? 编辑: 公开课信{[必需的]公共字符串内容{get;放;}[必需的][EnumDataType
..
Swagger 没有为 IActionResult 包装的对象生成模型
使用以下代码，Swaggger UI 显示 RegistrationInfo 模型，但不显示 UserInfo 模型. 我如何让它生成? [Produces("application/json")][授权(AuthenticationSchemes = JwtBearerDefaults.AuthenticationScheme)][路由(“api")]公共类 UserController
..
Swashbuckle 如何将 OneOf 声明添加到 OpenAPI 3
我有一个请求对象，它可以是 2 种字符串类型“A"；或“B". 注意:这是我真正想要的一个更简单的例子.枚举在这里对我不起作用. 公共类 SampleRequest{//只能是“A"或“B"公共字符串 Property1 { 获取；放;}} 我正在尝试创建一个可以作为 OpenAPI“OneOf"输出的模式过滤器.属性. https:///datatracker.ietf.org/
..
.Net Core 3.1 在 Swagger UI 上删除架构
我有 .Net 3.1 Web Api，我想删除这部分“Schemas"；在 Swagger UI 上. 怎么做? 解决方案 不需要架构过滤器.经过几天的努力，我发现: 所有需要做的事情都在 app.UseSwaggerUI(options =>{options.DefaultModelsExpandDepth(-1);}); 注意:它是 DefaultModels(复数)而不
..
在 SwaggerUI 中包含客户端 SDK 使用示例
我一直在寻找一种工具，它可以帮助我解析我的 JSON swagger 文件(甚至 YAML 文件)并基于 此示例 API 文档. 我已经试过了: codegen(所以我确实在 github 存储库中有代码示例，但我不知道如何在我的 UI 上动态获取它) slate，但我正在尝试继续大摇大摆 Widdershins 有人知道第三方工具能够产生这样的功能，还是我错过了 codeg
..
关于 Swagger API 的建议
我正在使用 Java 8 构建一个使用 SpringBoot 和 Spring REST 服务的 API.我刚刚发现了 Swagger API，现在我想让我的 API Swagger 兼容. 据我所知，Swagger 是一种记录 APIS 的工具，而且还提供了从规范(v2 中的 swagger.json)生成客户端和服务器代码的功能，此外还有一个很好的 Web 界面来与您的 API 交互.
..
使用 Swagger UI 设置 Api 版本
我有一个通过使用 Jersey 开发的 REST API，我们通过 swagger-ui 记录了 REST API.不幸的是，我们并没有从第一天开始对 API 进行版本控制.我们现在正在尝试向 API 添加版本控制. 我采取的第一步是尝试更新由动态生成的 swagger (html) 页面显示的 API 版本.我一直跟踪调用流程到 swagger-ui.js 文件，但我无法弄清楚如何更改
..