Документирование параметров запроса с помощью API Blueprint

Я пытаюсь документировать параметр запроса в API Blueprint, но я не совсем уверен, правильно ли я это сделал. Ресурс выглядит следующим образом:

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

Этот запрос дезактивирует пользователя, в то время как следующий пользователь удалит объект пользователя:

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

Это уценка Blueprint у меня для этого:

## 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-адресе примера. Является ли это просто неправильным пониманием графического интерфейса или должен запрашивать параметры запроса по-другому?

Ответы

Ответ 1

Ваш проект отлично подходит, проблема в том, что текущая документация Apiary не корректно обрабатывает параметры URI.

Не могли бы вы попробовать новую документацию? Он должен правильно обрабатывать параметры URI.

URI Parameters

Изменить

Правильный шаблон URI должен быть:

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

Ответ 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