如何为可选的枚举定义编写swagger文档？

Question

我有一个类似于

public Optional<Status> getStatus 

但无法弄清楚招摇规范的定义应该是什么样子的API。有以下情况swagger.io编辑错误消息没有太大意义：

get: 
    ... 
    responses: 
    '200': 
     description: OK 
     schema: 
     $ref: '#/definitions/Status' 

definitions: 
    Status: 
    properties: 
     type: string 
     description: Blah 
     enum: 
     - UNKNOWN 

Answer 1

还只是外“属性”财产造成的问题（如字符串不是对象）：

definitions: 
    Status: 
    type: string 
    description: Blah 
    enum: 
     - UNKNOWN