Swagger是一个框架实现，用于基于Open API规范描述，生成，使用和可视化RESTful Web服务
如何从 jsonresult 响应自动生成 OpenAPI 文档？
Swashbuckle可以根据代码自动生成API文档（有详细返回模型） [http获取] 公共 ActionResult> GetStudents() { 返回 CollegeReposi...
Swashbuckle.AspNetCore 必需的查询字符串参数
我有一个带有 Swashbuckle.AspNetCore 包的 ASP.NET Core v2.1 项目。 我的代码是： /// /// 为当前驱动程序设置新的android令牌 /// /// <
我正在尝试使用 swagger 来记录 API，但我很难弄清楚如何记录通过使用 POST 和所谓的隐藏 _method 参数来工作的 PUT/DELETE 方法，该参数表明...
如何为 FastAPI 中的每个端点生成独立的 Swagger UI 文档页面，而不是为一页中的所有端点生成 API 文档？
有没有办法在自己的页面上生成每个端点，而不是在单个页面上生成所有端点的文档，如下所示： 我想展示 GET 端点...
我正在尝试创建一个响应示例，该示例应返回如下数组： [ [ “店铺名称”, “53.7094190”， “-1.9084720” ,1 ] ] 为此，我使用以下代码： * @OA\Res...
我有一个 FormTemplateElement 类，它有几个子类型。我希望仅使用 @Schema 注释来生成模式。然而 Swagger 也在解析 Jackson 注释......
我正在 Node.js 中使用 swagger 来获取 API 文档。 现在我想使用头盔来确保安全，但是当我使用头盔时，会出现错误。 然而，如果我把头盔放在路由器下面大摇大摆，t...
使用带有 JsonNullable 字段的 mapstruct 时看不到该值
在我的mapstruct接口中，我有一个方法将Long转换为JsonNullable，这是swagger生成的类等待的类型（因为nullabe = true）： 默认 JsonNullable 在我的mapstruct接口中，我有一个方法将Long转换为JsonNullable，这是由swagger生成的类等待的类型（因为nullabe = true）： default JsonNullable<BigDecimal> map(Long value) { return value != null ? JsonNullable.of(BigDecimal.valueOf(value)) : JsonNullable.undefined(); } 当我处于调试状态时，没关系，JsonNullable 具有：present=true，value=80 例如。 当我使用休息客户端进行测试时，我在响应中没有值： "montant": { "present": true } 你知道为什么以及该怎么做吗？ 谢谢 基于 jackson-databind-nullable 的自述文件 您应该在 Jackson 上注册该模块 JsonNullableModule ObjectMapper ObjectMapper mapper = new ObjectMapper(); mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL); mapper.registerModule(new JsonNullableModule()); 不再以编程方式执行此操作，您可以定义模块的 bean： @Configuration public class JacksonConfiguration { @Bean public JsonNullableModule jsonNullableModule() { return new JsonNullableModule(); } } 这将自动注册，感谢 JacksonAutoConfiguration
无法从 Gitlab 内的 Swagger UI 调用外部 API。内容安全策略错误
我正在尝试在 GitLab 中使用 OpenAPI 文件（它为我的文件运行 UI），但是当我使用从 Swagger UI 尝试/执行功能（它向外部 API 发送请求）时，我收到错误与
如何使用 Swagger 以及 Nest.js API 和 SPA 之间共享的 DTO？
我有一个带有 Nest.js API 和 Angular SPA 的项目。 SPA 用于与 API 通信的 DTO 位于一个名为 Models 的单独项目中，我将其用作依赖项。这样一来，我...
使用 Swashbuckle.AspNetCore.Cli v6.4.0 生成 swagger.json 时出错
我已将此行添加到我的 .csproj 文件中 我已将此行添加到我的 .csproj 文件中 <Target Name="SwaggerPostBuildTarget" AfterTargets="PostBuildEvent"> <Exec Command="dotnet tool restore"></Exec> <Exec Command="dotnet tool install Swashbuckle.AspNetCore.Cli --version 6.4.0"></Exec> <Exec Command="dotnet swagger tofile --output swagger/v1/swagger.json $(OutputPath)$(AssemblyName).dll v1"></Exec> <Exec Command="dotnet swagger tofile --output swagger/v2/swagger.json $(OutputPath)$(AssemblyName).dll v2"></Exec> <Exec Command="dotnet swagger tofile --output swagger/v3/swagger.json $(OutputPath)$(AssemblyName).dll v3"></Exec> </Target> 当我运行该项目时，我收到此错误： MSB3073 - The command "dotnet swagger tofile --output /swagger/v1/swagger.json bin\Debug\net6.0\xxx.dll v1" exited with code -532462766 我一步步按照 https://github.com/domaindrivendev/Swashbuckle.AspNetCore#swashbuckleaspnetcorecli 中的说明进行操作，但它不起作用。 关于这个错误的含义有什么想法吗？ 更新 通过更多尝试，我了解到在执行构建后命令时，环境变量尚未设置，这就是导致我的错误的原因，因为我尝试读取环境变量。 这是我的 launchsettings.json： 这是我执行的输出： 我还注意到，正在侦听的端口不是我设置的端口，但我无法理解从哪里读取它们 更新2 我发现了这个：如何在csproj文件中获取环境变量？ 但它不起作用，我也无法得到澄清，因为我还不能发表评论。 github 上也有这个问题https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/2290解释了为什么我会收到此错误，但我仍然无法在没有错误的情况下构建项目 更新3 我已经能够生成 json 文件。现在我的 csproj 文件中的说明如下所示： 我的 Program.cs 文件是： using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Mvc.ApiExplorer; using Microsoft.Extensions.DependencyInjection; var builder = WebApplication.CreateBuilder(args); // Custom configurations var startup = new Startup(builder.Configuration); startup.ConfigureServices(builder.Services); var app = builder.Build(); startup.Configure(app, app.Environment, app.Services.GetRequiredService<IApiVersionDescriptionProvider>()); app.Run(); 我需要重新安装我的 dotnet 工具。 尝试运行此命令：dotnet tool restore 对我来说，这是因为控制器中的两个操作方法共享相同的名称“ExampleOne”，如下所示 [HttpPost("example/apiOne", Name = "exampleOne")] [ProducesResponseType(StatusCodes.Status204NoContent)] public async Task<IActionResult> ActionMethodOne() { return NoContent(); } [HttpPost("example/apiTwo", Name = "exampleOne")] [ProducesResponseType(StatusCodes.Status204NoContent)] public async Task<IActionResult> ActionMethodTwo() { return NoContent(); } 如果您设置了 NUGET_PACKAGES 环境变量，我找到了另一种方法来获取此错误。 如果您的 nuget 包未缓存在默认位置（即 Windows 上的 %userprofile%\.nuget\packages），那么您可能会看到 The command "dotnet swagger..." exited with code 1. 我通过将以下文件夹复制回 nuget 默认位置来验证这一点： swashbuckle.aspnetcore swashbuckle.aspnetcore.cli swashbuckle.aspnetcore.swagger swashbuckle.aspnetcore.swaggergen swashbuckle.aspnetcore.swaggerui 这导致错误消失，但我不建议将其作为修复方法。相反，您可能应该删除 NUGET_PACKAGES 环境变量，以便将软件包安装在默认位置（并保持最新）。
问题：定义“可选枚举”的查询参数类型时，Swagger UI 不再显示下拉项。 Swagger（打字稿）代码生成器无法处理 null 类型 ei...
如何将 swagger 与身份服务器集成到 ASP.NET Core Web API 中？
我已将 Swagger 集成到我的 ASP.NET Core Web API 项目中，但它只能访问不需要身份验证的端点： application.UseSwagger(); application.UseSwaggerUI(); 我怎样才能
在我的 net core api 应用程序中，所有控制器都继承自基本控制器。 因此，招摇是行不通的。 我使用 Visual Studio 创建了一个示例项目，并且 swagger 工作正常 但是……
我想从给定的 swagger.json 创建curl 请求？
我正在寻找一种解决方案，从java中的curl、GO、Node.js中的swagger.json中提取api请求！
如何使用 Jersey 禁用 OpenAPI 规范中的 /application.wadl
设置 我使用包含 Jersey 依赖项的 Initializr 中的 Spring Boot 应用程序，并添加 io.swagger.core.v3:swagger-jaxrs2:2.1.13 作为附加依赖项。然后我创建以下 ResourceC...
如何在 NestJS 中为 OpenAPI 注释采用多部分表单数据的端点
我的 NestJS 服务器有一个接受文件和附加表单数据的端点 例如，我在表单中传递一个文件和文件创建者的 user_id。 NestJS Swagger 需要被明确告知...
如何在node.js中使用swagger-autogen确定“属性”的顺序？
出于某种原因，swagger-autogen 正在颠倒 swagger.json 输出文件中属性的顺序。例如，我有一个简单的“用户”猫鼬模式，仅设置“用户名”和“密码”
我正在为我的休息服务使用 Swagger API 文档。我已经成功地将 Swagger 与我的代码集成并且它有效。 但我需要格式化 Swagger UI。由于
无法派生路径参数“id”的类型，因为它是无类型的并且从视图集中获取查询集失败
无法派生路径参数“id”的类型，因为它是无类型的，并且从视图集中获取查询集失败。考虑向路径添加类型（例如 int:id）或注释参数...