使用Swagger 2.0描述一组复杂对象

Question

我有一个Web Api 2项目，它有一个HttpGet方法，该方法将复杂对象的列表作为参数。像这样：

[HttpGet]
public string GetCoolStuff(List<ContainerContract> containers)

我用swashbuckle来设置我的swagger文档。但是它像这样设置这个参数:

{
  "name" : "containerContracts",
  "in" : "query",
  "required" : true,
  "type" : "array",
  "items" : {},
  "collectionFormat" : "multi"
}

至少项目对象似乎需要一些东西。

后来在定义部分，我确实发现了这一点：

"ContainerContract" : {
    "type" : "object",
    "properties" : {
        "Type" : {
            "type" : "string"
        },
        "Temperature" : {
            "type" : "string"
        },
        "CreatedWhen" : {
            "format" : "date-time",
            "type" : "string"
        }
    }

但它似乎没有被使用...

有没有办法设置它，让swagger理解这是一个对象列表，并给我一种为各个属性输入值的方法？（就像我对不是列表的复杂对象所做的那样。

下面是我在图片中的意思：

还是说Swagger Ui只是还没那么智能？(如果我必须编写Json来填充我的列表，那么我可以。)

以防万一，这里有一个< code>ContainerContract的例子:

public class ContainerContract
{
    public string Type { get; set; }
    public char Temperature { get; set; }
    public DateTime CreatedWhen { get; set; }
}

Answer 1

不幸的是，在2.0规范（Swashbuck使用的规范）中，查询参数中不能有复杂的对象，甚至数组中也不能。因此，在下一个版本之前，您希望执行的操作不受支持。您可以有一个数组，但＜code＞项