Swagger 打开单端点多个POST请求的Api文档

我正在尝试为我的单端点Api提供Swagger/Open Api文档

我的单端点看起来像

职位：

post正文确定逻辑路径和响应模式

Body1:{“jsonClass”：“animalstrankedbylifespan”}
响应1:schema-1

Body2:{“jsonClass”：“动物区”、“地区”：“非洲”、“类型”：“狮子”}
响应2:schema-2

对文档的期望：每个jsonClass在swagger（或任何其他）中作为单独的调用列出，我可以使用该规范来支持所有jsonClass

看起来不像，斯威格支持这种设计。如果有，请给我举个例子

---

是否有其他Api文档框架可用于为支持的每种jsonClass提供请求-响应文档？

OpenAPI 2.0和3.0无法在同一操作中将不同的请求模式映射到不同的响应模式。以下是相应的功能请求：

目前，如果您使用OpenAPI3.0，您可以使用

oneOf

为请求和响应定义多个可能的模式。但是，您不能定义

Body1

产生

schema-1

响应和

Body2

产生

schema-2

响应。您只能在操作说明中口头记录此信息

openapi:3.0.0
...
路径：
/傅：
职位：
请求主体：
必填项：true
内容：
应用程序/json：
模式：
其中一项：
-$ref:“#/components/schemas/Body1”
-$ref:“#/components/schemas/Body2”
响应：
'200':
描述：好的
内容：
应用程序/json：
模式：
其中一项：
-$ref:“#/components/schemas/schema-1”
-$ref:“#/components/schemas/schema-2”

我不知道，如果不调整swagger-ui，这是可能的。可能相关：