Swagger 2.0 如何在Swagger编辑器中将JSON对象作为多部分请求的一部分发送?

Swagger 2.0 如何在Swagger编辑器中将JSON对象作为多部分请求的一部分发送?,swagger-2.0,openapi,swagger-editor,Swagger 2.0,Openapi,Swagger Editor,我正在使用Swagger编辑器编写API文档,但在包含JSON对象的多部分POST请求中遇到问题。这是我的招摇过市YAML文件: swagger:'2.0' 信息: 版本:1.0.0 标题:文档API 路径: /代理人: 职位: 消耗: -多部分/表单数据 生产: -文本/html 参数: -in:查询 名称:方法 description:要访问的方法的名称 必填项:true 类型:字符串 -在:身体 姓名:param description:要发送的参数 必填项:true 模式: $ref:“

我正在使用Swagger编辑器编写API文档,但在包含JSON对象的多部分POST请求中遇到问题。这是我的招摇过市YAML文件:

swagger:'2.0'
信息:
版本:1.0.0
标题:文档API
路径:
/代理人:
职位:
消耗:
-多部分/表单数据
生产:
-文本/html
参数:
-in:查询
名称:方法
description:要访问的方法的名称
必填项:true
类型:字符串
-在:身体
姓名:param
description:要发送的参数
必填项:true
模式:
$ref:“#/definitions/Param”
响应:
201:
描述:项目已创建
400:
说明:输入无效,对象无效
409:
说明:现有项已存在
定义:

Param:#
multipart/*
包含JSON对象的请求可以使用OpenAPI 3.0描述,但不能使用OpenAPI/Swagger 2.0

OpenAPI 3.0 OpenAPI 3.0本机支持以下请求:

路径:
/代理人:
职位:
参数:
-in:查询
名称:方法
description:要访问的方法的名称
必填项:true
模式:
类型:字符串
请求主体:
必填项:true
内容:
多部分/表单数据:
模式:
类型:对象
特性:
#这里,“param”是多部分负载中的部分/参数名称。
#参数值是由“Param”模式定义的对象。
#对象的默认内容类型是application/json。
参数:
$ref:“#/components/schemas/Param”
响应:
...
OpenAPI 2.0 在OpenAPI/Swagger 2.0中,当使用表单数据(
application/x-www-form-urlencoded
multipart/form data
)时,值为JSON字符串的表单参数仅描述为
type:string
,您无法定义JSON字符串的结构

路径:
/代理人:
职位:
消耗:
-多部分/表单数据
生产:
-文本/html
参数:
- ...
-in:formData#+1,并且现在3.0已经推出,它们已经存在。
curl -X POST "https://localhost/v1/api/agent?method=login" -H  "accept: text/html" -H  "content-type: multipart/form-data" -F {"username":"1234567890","password":"1234567890","imsi":"310260000000000","imei":"000000000000000","deviceId":"9ca9b02b237a6dae"}
curl -X POST "https://localhost/v1/api/agent?method=login" -H  "accept: text/html" -H  "content-type: multipart/form-data" -F 'param={"username":"1234567890","password":"1234567890","imsi":"310260000000000","imei":"000000000000000","deviceId":"9ca9b02b237a6dae"}'