帶有int值的Swagger枚舉

Question

我想生成一個包含枚舉的swagger-json。 我的問題是枚舉的呈現方式：

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

我真正想要的是可能值的名稱（第一，第二，第三）以及枚舉值（0,1,2）背后的值。 甚至可以生成這樣一個json（這是“swagger-valid”），如果是這樣，怎么樣？

Answer 1

我使用NSwag，與此同時，NSwag的Rico Suter提供了該功能。 他的大道具！

Answer 2

當前版本的OpenAPI（fka.Swagger）不建議這樣做。 它可能會在下一個版本中添加（參見https://github.com/OAI/OpenAPI-Specification/issues/348 ）

同時有同樣的問題，我結束了在屬性描述中給出這些信息。