Rest API蓝图模式使用

Rest API蓝图模式使用,rest,documentation,apiblueprint,Rest,Documentation,Apiblueprint,我们希望与模式一起使用。比方说,我们希望指定PUT to a resource接受有效负载中的帐户,GET on the same resource返回帐户有效负载。所以我需要指定GET和PUT中使用的帐户,并且需要指定帐户本身。我不知道在哪里指定它,规范的方式是什么?不幸的是,我无法在示例中找到它。在多个操作中重用一个消息负载是可以利用消息负载概念的地方 只需定义一个帐户模型,然后像这样重复使用它: # Account [/account] + Model (application/json

我们希望与模式一起使用。比方说,我们希望指定PUT to a resource接受有效负载中的帐户,GET on the same resource返回帐户有效负载。所以我需要指定GET和PUT中使用的帐户,并且需要指定帐户本身。我不知道在哪里指定它,规范的方式是什么?不幸的是,我无法在示例中找到它。

在多个操作中重用一个消息负载是可以利用消息负载概念的地方

只需定义一个帐户模型,然后像这样重复使用它:

# Account [/account]

+ Model (application/json)
    + Body

            { ... }

    + Schema

            { ... }

## Retrieve an Account [GET]

+ Response 200

    [Account][]


## Update an Account [PUT]

+ Request

    [Account][]

+ Response 204