为什么Swagger-UI没有主题？
我非常喜欢使用Swagger来记录Restful API，尤其是其中的“试一试！”按钮，但是swagger-ui界面看起来不太酷炫。 我无法相信这样一个优秀的开源工具没有任何模板可用（或者我找不到）？ 我不需要免费的…像http://getbootstrap.com/有很多可以购买主题的...
Swagger .NET Core API: Action 方法的 HTTP 方法不明确错误
使用.NET Core 2 API实现Swashbuckle/Swagger时，访问swagger.json时出现500错误: NotSupportedException: 操作存在模棱两可的HTTP方法 - EBisAPI.Controllers._class.HandleError...
OpenAPI中的'required'到底是什么意思？
鉴于以下OpenAPI定义Person: required: - id type: object properties: id: type: string 以下哪些对象是有效的？只有A还是A和B都有效？ A. {"id": &quo...
操作需要在Swagger中具有唯一的方法/路径组合
我在同一个控制器中有两个HTTP GET方法，导致出现以下错误： DPK.HostApi.Controllers.DataStoreController.GetByIdAsync (DPK.HostApi)和DPK.HostApi.Controllers.DataStoreContro...
Swagger编辑器显示路径参数的“模式错误：不应有附加属性”错误
我正在使用http://editor.swagger.io设计API，但是遇到了一个错误，我不知道如何解决： Schema error at paths['/employees/{employeeId}/roles'].get.parameters[0] should NOT have ad...
如何从Swagger模式生成基本的TypeScript接口？
我正在寻找一种从Swagger模式生成简单TypeScript接口的方法。大多数我找到的解决方案都过于复杂。 我希望生成类似于以下这样的接口：export interface IBar { a?: string; b: number; c: Date; baz...
Swagger是否可以根据现有的express路由自动生成其yaml文件？
我继承了一个现有的API，并希望使用Swagger对其进行文档化，但我还不完全了解其全部范围。 Swagger（或其他中间件/工具）是否可以根据现有的express路由自动生成yaml（用于swagger）？ 从其他问题中看到的情况，似乎这主要是手动工作，但我正在仔细检查是否有人找到了解决方法。
Swagger、Swashbuckle和Swashbuckle UI是什么？
这是我的理解： Swagger是一种编写文档的标记/规则。但为什么它被称为框架（像Angular/MVC）？ Swashbuckle是一个程序（JavaScript？），用于根据Swagger规则生成文档。 Swagger UI显示文档。它使用Swashbuckle来完成此操作。 这些...
如何从样本JSON生成Swagger #definition
从宠物店示例中取以下的 #definition。可以生成一个JSON结构体。 例如： 有没有什么工具能够反过来操作，即给定一份复杂的大型 JSON 文件，能否得到对应的 #definition 部分呢？ 给定下面的 JSON 结构体，我是否能够生成 swagger 文件的 #defin...
Swagger是什么？它与OData有什么关系？
我熟悉微软的技术栈。我在一些RESTful服务中使用OData。最近，我了解到Swagger可以用于API文档，我正在尝试理解它与OData之间的关系。它们都似乎是RESTful规范。哪一个更为广泛地使用？