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

Question

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

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

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

Answer 1

你可以使用additionalProperties来定义一个hashmap（“?????”是这个hashmap中的一个键，不需要定义它）：

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

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

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