119得票13回答
Swagger/OpenAPI模拟服务器

我有一个Swagger文件中的API参考文档,我想创建一个非常简单的模拟服务器,这样当我调用例如: mymockurl.com/users 时,它会返回预定义的JSON(无需连接到数据库)。 最简单的方法是什么?我不是后端开发人员。

114得票39回答
ASP.NET Core - Swashbuckle未创建swagger.json文件

我无法让 Swashbuckle.AspNetCore (1.0.0) 包生成任何输出。我阅读到 swagger.json 文件应该写入 '~/swagger/docs/v1'。但是,我没有得到任何输出。 我从一个全新的 ASP.NET Core API 项目开始。我应该提到这是 ASP.N...

114得票3回答
如何基于现有的Postman集合生成Swagger文档?

我正在开发一个REST API。在开发过程中,我使用了Postman(Chrome扩展程序)来使用和记录我的API。这是一个很棒的工具,我把大部分的API端点都放在了里面。 然而,随着我们接近发布,我想用Swagger来记录这个API,我该如何做呢?有没有办法可以根据Postman导出的内容生...

112得票9回答
Swagger错误:schemaIds冲突:检测到类型A和B的重复schemaIds。

使用Web API并使用Swashbuckle生成Swagger文档时,我在两个不同的命名空间中定义了两个具有相同名称的不同类。当我在浏览器中打开Swagger页面时,它会显示以下信息: “冲突的schemaIds:检测到类型A和B的重复schemaIds。请参见配置设置 - “UseFul...

106得票13回答
Swagger类型错误:无法在“Window”上执行“fetch”:使用GET/HEAD方法的请求不能有正文。

我已经将Swagger添加到了我的Spring Boot 2应用程序中:这是我的Swagger配置: @Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket api() ...

101得票2回答
Swagger/OpenAPI - 使用 $ref 传递可重用的定义参数

假设我有一个参数叫做limit。这个参数在许多地方都被使用,如果我需要更新它,那么要到处修改它就很麻烦:parameters: - name: limit in: query description: Limits the number of returned ...

97得票3回答
如何在OpenAPI/Swagger中指定字段是可选的还是必需的?

如何在OpenAPI / Swagger中定义字段是可选还是必需的,以及默认值是什么? 如何在OpenAPI / Swagger中定义字段是可选还是必需的,以及默认值是什么?

96得票21回答
如何配置Swashbuckle以忽略模型上的属性?

我正在使用Swashbuckle为webapi2项目生成swagger文档/用户界面。我们的模型与一些旧接口共享,因此有一些属性我想在模型上忽略。我无法使用JsonIgnore属性,因为旧接口也需要序列化为JSON,所以我不想全局忽略属性,只想在Swashbuckle配置中忽略它们。 我在这...

95得票4回答
Swagger继承和组合

在我的“简化”API中,所有的响应都是从一个基本的“响应”类中派生(继承)而来。响应类由一个包含元数据的头部和包含用户请求的核心数据的主体组成。响应(以JSON格式)的布局是这样的:所有元数据都在第一个“层”上,主体是一个名为“body”的单个属性。response |--metadata a...

92得票20回答
如何在Swagger-UI中打开本地文件

我想使用swagger-ui在本地计算机上打开自己生成的Swagger规范文件my.json。 因此,我下载了最新的标记v2.1.8-M1并解压缩了ZIP文件。然后我进入子文件夹dist并将文件my.json复制到其中。现在我打开了index.html并想要探索my.json。这里问题开始出...