具有数组值的键的Swagger模型

Question

我被困在创建一个具有键和数组值的模型上。但是我无法得到我预期的结果。指导我如何达到预期效果

"models":{  
      "SearchTask":{  
         "id":"SearchTask",
         "properties":{  
            "taskStatusList":{  
               "type": "array",
                "items": {
               "type": "string"
            }
         }
      }
   }
}

{
        "taskStatusList": ["String"]

}

 {
            "taskStatusList": ["a","b"]

    }

Answer 1

对于数组内部类型，可以使用example构造为值提供一个示例：

{
  "models": {
    "SearchTask": {
      "id": "SearchTask",
      "properties": {
        "taskStatusList": {
          "type": "array",
          "items": {
            "type": "string",
            "example": "a"
          }
        }
      }
    }
  }
}

当前规范不能有多个示例，因此不能获得[“a”,“b”]。如果您觉得这是一个重要且常见的用例，请将问题添加到OAI规范存储库中。