具有微小变化的Swagger/OpenAPI ResponseBodies参数

Question

如何更改或添加$ref的一部分？

我有一个OpenAPI 3.x响应体：

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

描述性文本适用于我所使用的每个实例，但最后一行除外。这对每个产品都有影响，就像产品编号一样。

有类似的问题，但关于似乎不适用的模式，任何操作符也不适用。我想应该是这样的，但是当然，这是行不通的，因为$ref不能使用任何额外的操作。

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

Answer 1

这不起作用，因为$ref不能使用任何额外的操作。

您的示例将适用于OpenAPI 3.1 (2021年2月16日发布的新版本)。美洲国家组织3.1支持拥有一个description和$ref。对于非模式$refs，相邻的description应该定义在引用的组件中(如果有的话)。