如何在API蓝图中记录路径中的可选参数？

Question

假设有一个具有可选参数的URL路径的API：

## Get FooBar [/foo/bar/{type}] 

+ Parameters 
    + type (optional, string, `widget`) ... Filter for a specific bar type 

当然的type参数确实应该查询参数，但API实现，因为它是和不能优化。

type可以在URI模板中表示这种可选性吗？

Answer 1

是的，你可以显示可选参数，只需在问号前添加它们的块。

## Get FooBar [/foo/bar/{?type} 

+Parameters 

    +type (optional) The widget type you want back, if any.