招摇过市：第一个枚举值覆盖类型

Question

我正在使用swagger doc为我的应用程序生成API。doc是用yml编写的，在某些地方它将定义一些枚举道具（我们使用mysql）。这看起来像：

properties:
      type:
        enum:
          - "first"
          - "second"
          - "example"
        type: "string"
      title:
        type: "string"
    ... // And so on and on

我希望得到这样的东西：

{
  "type": "string",
  "title": "string",
}

正如您所看到的，类型字段将是一个在配置文件中定义的字符串，但我收到的是这个字符串：

{
  "type": "first",
  "title": "string",
}

Swagger将第一个值设置为数据类型，这是绝对错误的。所以问题是如何为“type”字段获取值“string”。

Answer 1

我一直在写我的昂首阔步留档在JSON。下面是我如何设置“枚举”的一个例子。也许你可以把它翻译成YML来得到一个更好的主意。

"parameters":[
           {
              "name":"userID",
              "in":"path",
              "description":"TO BE DETERMINED.",
              "required":true,
              "type":"string"
           },
           {
              "name":"embedded",
              "in":"query",
              "description":"TO BE DETERMINED",
              "required":false,
              "type":"array",
              "items":{
                 "enum":[
                    "address",
                    "state"
                 ]
              },
              "collectionFormat":"csv"
           }

如果你看项目，你会发现我没有使用类型，它工作得很好。