在 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 架构，然后为使用 allOf 的 petId/itemIdOrders 单独架构。

查看this answer 以获取另一个示例（或this 获取更具体的示例！）。