node.js上swagger中的可空字段

Question

我花了很多时间试图找到在Node.js中创建大摇大摆文档的解决方案。主库是swagger-node，在其中创建一个swagger yaml文件，然后向其中添加控制器。它会自动在应用程序中提供大摇大摆的ui文档，并根据YAML中指定的模型对请求和响应进行验证。

这很简单，但是我要求某些字段能够显式地返回或接受null作为值，例如：

{ 
  id: 123,
  description: "string",
  date_sent: null
}

我想知道有没有变通的办法？可以添加具有x-nullable供应商特定标志的node可用库，或者以某种方式指定我的非必填字段应该全部为nullable。

我是否必须自己编写一些东西，然后在验证器中间件运行之前对其进行修改，或者有人可以建议一些解决方案？

Answer 1

OpenAPI（fka Swagger）规范V3.0.0支持nullable字段，但在V2.0中不支持。可为空的类型定义如下：

# Can be string or null
type: string
nullable: true