swagger - 在 OpenAPI 3 中将参数传递给 `$ref`

Question

假设我有以下模式稍后使用 $ref 重用:

"schemas": {
      "Order": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "petId": {
            "type": "integer",
            "format": "int64"
          }
        }
      }

但我有另一个与此类似的架构:

"schemas": {
      "Order": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "itemId": {
            "type": "integer",
            "format": "int64"
          }
        }
      }

它们之间唯一的区别是 itemId和 petId ，我只想创建一个架构并通过 itemId或 petId引用时。
如何做到这一点？有没有其他替代解决方案？

Answer 1

真的没有办法沿着模式引用传递参数。

在您的情况下，我们可以做的是拥有一个基础 Order仅具有公共(public)属性的架构，然后为 petId 分离架构/itemId Order s 使用 allOf .

查询 this answer再举一个例子(或 this 更具体的例子!)。