问题标签 [swagger-editor]

我有一个关于如何使用 yaml 语法在 swagger 中定义引用数组的问题。我有以下定义我的字段的 yaml 片段：

定义如下：

在我的领域的预览中，一切看起来都很好：

但是我收到了错误“不是有效的参数定义”，并且在详细的错误中我收到了“数据与'oneOf'中的任何模式都不匹配”。

我在文档中找不到这样的东西。那么什么是正确的结构或者我错过了什么？

我在工作空间的根目录中创建了新项目（nodeJS），过了一段时间我想分离项目的客户端和服务器端。为此，我在项目的根目录中创建了两个文件夹（服务器和客户端），并将所有文件和目录移动到适当的文件夹。

之后我无法启动服务器，因为它说 Swagger 找不到swagger.yaml文件（我将它移到服务器文件夹）

我试图在节点服务器的配置文件夹中编辑default.yaml文件，但问题仍然存在。

有没有办法将 swagger 项目配置指向新的 laction（目录-> 服务器文件夹）？

默认.yaml：

编辑：添加了 app.js

应用程序.js：

我花了很多时间试图找到在 Node.JS 中创建 swagger 文档的解决方案。主库是 swagger-node，您可以在其中创建一个 swagger yaml 文件，然后将控制器添加到其中。它会自动在您的应用程序中提供 swagger ui 文档，并针对您在 yaml 中指定的模型对请求和响应进行验证。

这很简洁，但是我有一个要求，我希望明确地能够返回或接受一些字段null作为值，例如：

我不想删除date_sent密钥，我想明确地将其声明为空。

我相信，swagger 规范不支持anyOfJSON 模式通常如何做到这一点。

我想知道是否有解决方法？也许某些可用于节点的库具有x-nullable可以添加的供应商特定标志，或者以某种方式指定我的非必填字段都应该为空。

我是否必须自己编写一些东西来获取我的 swagger 文件，然后在验证器中间件运行之前对其进行修改，还是有人可以建议一些解决方法？

嗨，我正在尝试通过正文参数发送默认值，但在提交时未使用。任何人都可以在这个问题上帮助我。这是我的代码，我正在尝试通过正文发送默认名称参数

嗨，我有一个为我的 API 编写的 swagger 文件，我无法测试我的 API 的路径，因为我得到：ERROR Server not found or an error occurred因为我的路径都是 localhost，所以我如何在本地使用 swagger？谢谢你

我正在尝试将 swagger 用于我的 RESTful api（.net 和 c#）。它是一个自定义的 restful api（不是 ASP.NET Web API 也不是 Web 应用程序）。

我正在使用 NSwag ( https://github.com/NSwag/NSwag )，它有 NSwagStudio 来生成规范，但没有成功，因为它没有指定方法。有没有其他方法可以做到这一点？如何让 swagger 了解我对操作的自定义属性？

我对 Swagger 工具很陌生。有谁知道如何在 Intellij Idea 中使用 Swagger Editor 工具而不是在线编辑器格式？

我对大摇大摆还很陌生，希望能在好的学习资源上找到一些方向。

我有一个我正在整理的测试项目，我遇到了一些问题。

我收到一条错误消息，说我的“删除”块中的“参数”无效。从我在示例中看到的内容来看，这对我来说还不错。但显然我错过了一些东西。有任何想法吗？

我想创建一个接收 POST 发送的 XML 字符串的 REST API 方法。我正在使用Swagger Editor自上而下设计我的 REST API 并生成服务器存根代码。

我的 POST 方法如下所示swagger.yaml：

我在 yaml 文件中也有这个全局设置：

当我使用 Swagger Editor 的Generate Server > Spring菜单选项时，会为 POST 方法生成以下接口方法：

这是相应的存根实现：

我使用 Postman 将一些虚拟 XML 发布到我正在运行的 Springboot 服务上的方法中：

但是当我打印出model实现方法内部的值时，log.debug("Model XML = " + model);我在日志中得到如下输出：

如何将 XML 本身转化为 的值model？在这个例子中，我希望它是这样的：

请记住，我不能直接编辑 Java 方法签名，因为 Swagger 编辑器正在生成它们。如果我的招摇定义是错误的，我应该使用什么来发布 XML 字符串？

实际上，XML 可能很大，因此不能将其作为请求参数发送。我也不打算处理 XML，因此可以将其视为字符串。

我有一个用于在线 Swagger 编辑器的有效 Json 文件。如何为 API 设置完整的 URL 以进行测试，例如https://mywebsite/api/apiMethod

目前我得到的是：