rest - apiary：忽略无法识别的块

Question

对于发布访问权限的服务，我在 apiary 中有以下定义：

## 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

Apiary 告诉我请求和响应块无法识别。我试图使字段成为必填项，我使参数成为必填项，我更改了字段的拼写，我删除了（应用程序/json），我摆弄了间距。似乎没有任何帮助。请求和响应块有什么问题？

Answer 1

方法名称必须全部大写，如规范和在线。

因此，“Assign access rights”这一行应该写成如下：

### 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 验证为有效 API 蓝图。问题已经解决了！