假设有一个具有可选参数的URL路径的API: ## Get FooBar [/foo/bar/{type}]
+ Parameters
+ type (optional, string, `widget`) ... Filter for a specific bar type
当然的type参数确实应该查询参数,但API实现,因为它是和不能优化。 type可以在URI模板中表示这
生成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
我正在使用API蓝图记录API,并且我有几个端点使用具有相同值的相同枚举类型。我不想在使用这个枚举的每一点重复所有的值,而是把它放在数据结构部分,并且只是引用它,从而使它变干。但是,我无法从文档中找出如何将枚举放入数据结构部分。我可以做对象很好,但它似乎忽略指定的成员,当我在数据结构部分声明一个枚举。 这里是什么,我现在有一个(很做作)的例子(不是DRY): ### Some Request