具有 int 值的 Swagger 枚举答案

【问题标题】：Swagger enum with int values具有 int 值的 Swagger 枚举
【发布时间】：2016-03-05 04:57:11
【问题描述】：

我想生成一个包含枚举的 swagger-json。我的问题是枚举的渲染方式：

"MyEnumType": {
  "typeName": "MyEnumType",
  "type": "string",
  "enum": [
    "first",
    "second",
    "third"
  ]
}

我真正想要的是可能值的名称（第一、第二、第三）以及枚举值背后的值（0、1、2）。是否有可能生成这样的 json（即“swagger-valid”），如果可以，如何生成？

【问题讨论】：

【解决方案1】：

当前版本的 OpenAPI (fka. Swagger) 不建议这样做。它可能会在下一个版本中添加（参见https://github.com/OAI/OpenAPI-Specification/issues/348）

与此同时，我也遇到了同样的问题，因此我结束了在房产描述中提供这些信息。

【讨论】：

【解决方案2】：

我使用 NSwag，与此同时，来自 NSwag 的 Rico Suter 提供了该功能。给他的大道具！

【讨论】：