Различные запросы на одно и то же действие с параметрами

Question

Я хочу найти (скажем) «accounts» на основе «имени» или «статуса».

Так что я хотел бы иметь два действия:

• GET /persons/?q=name==Jea*
• GET /persons/?q=status==locked

Как я могу документально подтвердить, что?

Я попробовал Action с кратными сделок:

### GET /accounts{?q} 

+ Request by name 
    +Parameters 
     +q (required, FIQLQuery) 
     **Only name is supported** 

+ Request by status 
    +Parameters 
     +q (required, FIQLQuery) 
     **Only status is supported** 

Но Пасека редактор жалуется, потому что:

1. я должен предоставить тело сообщения для моих запросов GET:

   Ожидается, что актив тела сообщения будет предварительно отформатированным кодовым блоком, каждая строка которого будет отклонена ровно на 8 пробелов или 2 вкладки.

2. + Parameters блок не распознается:

   Игнорирование непризнанный блок

Большое спасибо

Answer 1

я могу сделать решение, которое работает для меня.

Попробуйте этот API Blueprint:

FORMAT: 1A 

# requestByname 

## Accounts [/accounts/?{q,type}] 

### GET 

+ Parameters 
    + q (required, FIQLQuery) 
    + type (string, `name` or `status`) 

+ Request Name (application/json) 

+ Response 200 

     {"name": "test"} 

+ Request Status (application/json) 

+ Response 200 

     {"status": 200}