生成JSON的身體是否有一個工具從API藍圖語法使得例如JSON機構幫助? 例如,如果我已經制定了這樣的屬性: + Attributes (object)
+ data (array)
+ (object)
+ id: 100 (number) - The ID for the particular EPG object
+ title: "Vik
我有一個是這樣的一個API藍圖: ## Organization Users [/organizations/{id}/Users]
+ Parameters
+ id (string, required) - path variable, id of the organization.
some text was here.
### Get Org Use
假設有一個具有可選參數的URL路徑的API: ## Get FooBar [/foo/bar/{type}]
+ Parameters
+ type (optional, string, `widget`) ... Filter for a specific bar type
當然的type參數確實應該查詢參數,但API實現,因爲它是和不能優化。 type可以在URI模板中表示這
我正在使用API藍圖記錄API,並且我有幾個端點使用具有相同值的相同枚舉類型。我不想在使用這個枚舉的每一點重複所有的值,而是把它放在數據結構部分,並且只是引用它,從而使它變幹。但是,我無法從文檔中找出如何將枚舉放入數據結構部分。我可以做對象很好,但它似乎忽略指定的成員,當我在數據結構部分聲明一個枚舉。 這裏是什麼,我現在有一個(很做作)的例子(不是DRY): ### Some Request