如何爲可選的枚舉定義編寫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