属性和additionalProperties可以在Swagger 2.0中采用空值吗？

Question

auto

请注意，我没有定义任何必需的属性。

我注意到，在提出请求时，我可以拥有height = None

然而，在我的回答中，如果bark = None，则swagger抛出验证错误，None不是“string”类型。

使属性（和additionalProperties）为null的规则是什么，即使它们没有被定义为必需，也是如此？

我注意到对于根据需要定义的属性，必须是它们存在且不为空的情况。如果我想允许该属性为null，我必须包含“x-nullable”：true。

我是否必须包含“x-nullable”：对于不需要的属性是否为true？

为什么我看到不一致？

Answer 1

OpenAPI 2.0不支持null作为数据类型。有些工具使用x-nullable: true来处理空值，但它不是OpenAPI规范的一部分，因此它是否可行取决于您使用的工具。

OpenAPI 3.0中添加了对null的支持，其中属性可以标记为nullable: true。