Swagger/OpenAPI ResponseBodies参数略有差异

Question

如何更改$ref的一部分，或添加到其中？

我有一个OpenAPI 3。x响应机构：

ordernumber:
  $ref: '#/components/requestBodies/ordernumber'
 

说明性文本适用于我在本文中使用的每个实例，最后一行除外。每种产品都会发生变化，比如产品编号。

也有类似的问题，但关于似乎不适用的模式，anyof运算符也不适用。我猜应该是这样的，但当然，这不起作用，因为$ref不能使用额外的操作。

ordernumber:
  $ref: '#/components/requestBodies/ordernumber'
  description: For all units number T100-T1200.

Answer 1

这不起作用，因为$ref不能使用其他操作。

您的示例将在OpenAPI 3.1（2021年2月16日发布的新版本）中运行。代码旁边有 。如果是非schema$refs，则相邻的 描述应该覆盖引用组件（如果有）中定义的描述。