如何定义未知名称的 swagger 属性？

Question

我需要定义一个没有已知名称的 swagger 属性。

{
  "type": "object",
  "properties": {
      "?????": {
          "type": "array",
          "items": { "$ref": "#/definitions/ModelRelease" }
      }
}

这个??????我的定义的一部分是一个未知值的整数。有什么想法吗？

Answer 1

您可以使用 additionalProperties 来定义哈希映射（“??????”是此哈希映射中的键，无需定义它）：

{ 
  "type": "object", 
  "additionalProperties": { 
    "type": "array", 
    "items": { 
      "$ref": "#/definitions/ModelRelease" 
    }
  }
}

在一般情况下，hashmaps 可以有任意数量的项目，但您可以使用 minProperties 和 maxProperties 来限制项目数量。例如，如果您的对象必须只有一个属性:

{ 
  "type": "object",
  "additionalProperties": {
    "type": "array",
    "items": {
      "$ref": "#/definitions/ModelRelease" 
    }
  },
  "minProperties": 1,
  "maxProperties": 1
}

如何定义未知名称的 swagger 属性？

How to define swagger property that is an unknown name?

swagger