使用API​​ Blueprint记录查询参数

Question

我正在尝试在API蓝图中记录查询参数，但我不完全确定我是否已正确完成。资源如下所示：

DELETE http://baasar.apiary-mock.com/user/{appId}/{userId}

该请求将停用用户，而以下内容将删除用户对象：

DELETE http://baasar.apiary-mock.com/user/{appId}/{userId}?force=true

这是我对此的蓝图降价：

## User [/user/{appId}/{userId}]
Handle user objects

+ Parameters
    + appId (required, number, `1`) ... Application ID (`appId`)
    + userId (required, number, `1`) ... Numeric `userId` of the User object to manage

### Remove an User [DELETE]
+ Parameters
    + force (optional, boolean, `false`) ... Set to `true` to remove instead of deactivate

+ Response 204

但是，当使用Apiary渲染时，我只在参数列表中看到force，但它现在显示在示例URL中。这只是我误解了GUI或者应该以另一种方式记录查询参数吗？

Answer 1

您的蓝图非常好，问题是当前的Apiary文档无法正确处理URI参数。

你可以试试new documentation吗？它应该正确处理URI参数。

修改

正确的URI模板应为：

http://baasar.apiary-mock.com/user/{appId}/{userId}{?force}

Answer 2

我的卷曲请求：

curl -k -u username:password https://api.techie8.io/api/1.0/bits?bit_type=1

蜂房蓝图：

## Bits Collection [/bits?bit_type={bit_type}]

### List Latest bits [GET]

List all bits recently inserted into database.

+ Parameters
    + bit_type (number, optional, `1`) ... Type of bit to retrieve: 1: Bits, 2: Newsletter