пасеки: Игнорирование непризнанного блок

Question

У меня есть следующее определение в пасеке для службы размещать права доступа:

## Access Right [/api/v0.3/accessrights/{id}/assign?isExternalKey=true] 

### Assign access rights [Post]    

+ accessRightId (number) 
+ personId (string) 

+ Parameters 
    + id (number) - ID of the Access Right in the form of an integer 

+ Request (application/json) 

      { 
       "personId": "785" 
      } 

+ Response 201 

Пасека сказать мне, что запрос и блок отклика является непризнанными. Я попытался сделать необходимые поля, я сделал требуемый параметр, я изменил написание полей, я удалил (application/json), я возился с интервалом. Кажется, ничего не помогает. Что случилось с блоком «Запрос и ответ»?

Answer 1

Имена методов должны быть все-шапки, как в спецификации, так и в проводке.

Поэтому линия «Назначение прав доступа» должен быть записан следующим образом:

### Assign access rights [POST] 

Answer 2

Переключая порядок блоков (от параметров, запрос, ответ на запрос, ответ, Параметры), запрос и ответ тела признаются:

## Access Right [/api/v0.3/accessrights/{id}/assign?isExternalKey=true] 

### Assign access rights [Post]    

+ accessRightId (number) 
+ personId (string) 

+ Request (application/json) 

      { 
       "personId": "785" 
      } 

+ Response 201 

+ Parameters 
    + id (number) - ID of the Access Right in the form of an integer 

Я не уверен, почему это имеет значение, но по крайней мере, теперь API проверяется как Valid API Blueprint. Проблема решена!