Blueprint API顯示響應正文中Enum的所有可能值

Question

爲休息服務編寫API-Deocumentation時遇到了一個問題，我想列出所有可能作爲響應返回的值。

在下面的情況下，它可能是「狀態」字段，它可能包含任何可能的枚舉值，我想總結哪些可能的狀態。

我找不到一個簡單而好的方法來用apiblueprint做到這一點。有沒有辦法顯示默認情況下摺疊的部分，並在需要其他信息時展開它們？

下面是示例代碼，我有：

## Sample [/Sample?{id}] 
Get all the information for the sample 

+ Parameters 
    + id = `0` (Integer, optional) ... The Id of the resource to get 

+ Model (application/json) 

    + Body 

      { 
       "name": "Name of the Resource", 
       "state": "deleted" 
      } 

### Retrieve the sample data of the system [GET] 
+ Response 200 
    [ProviderConfiguration][] 

我需要的東西，如「值」參數部分但對身體部位來形容在主體部分國家如

<collapsible> 
+ state (EnumType) ... current state of the sample object 
    + Values 
    + `active` 
    + `inactive` 
    + `deleted` 
</collapsible> 

Answer 1

不幸的是，API Blueprint還不能實現。然而，它的計劃 - 見https://github.com/apiaryio/api-blueprint/issues/25和https://github.com/apiaryio/mson。