Swagger 编辑器 - 将请求 json 正文字段声明为 formData,但将它们作为 json 发送

Swagger Editor - declare request json body fields as formData, but send these as json

我使用的是最新的 Swagger 编辑器,我的服务器 api 只接受 json 正文请求,但是如果您使用 formData 文档声明参数,开发人员将很清楚。我的问题:如何将参数声明为 formData 但在尝试发送 json 正文请求时。我尝试了 Swagger Editor 最旧版本 2.9.6 并将参数声明为 formData 并将 "produces" 和 "consumes" 声明为 "application/json" 然后如果我在编辑器上尝试它工作,但是如果我生成 nodejs-server并尝试发送内容类型为 form-url-encoding,查看以下屏幕截图:

如果我生成 nodejs-server,则不起作用:

How to I can declare parameter as formData but when try it send json body request.

你不能。 API 规范是客户端和服务器之间的契约,应该精确定义服务器行为。如果服务器需要 JSON,规范必须使用 in: body 参数而不是 in: formData。如果服务器以一种方式工作而规范以另一种方式工作,那是没用的。

如果您想在规范中使用 formData 参数,请更改您的服务器以接受表单数据并相应地编写规范。