rest - API 蓝图模式使用

Question

我们要使用 API blueprint连同模式。比方说，我们要指定资源的 PUT 接受有效负载中的帐户，并且同一资源上的 GET 返回帐户有效负载。所以我需要指定在 GET 和 PUT 中使用的 Account 并且我需要指定 Account 本身。我不知道在哪里指定它，规范的方式是什么？不幸的是，我无法在示例中找到它。

Answer 1

在多个操作中重用一个消息有效负载是可以利用 resource model 的概念的地方。 .

只需定义一个帐户模型，然后像这样稍后重用它:

# Account [/account]

+ Model (application/json)
    + Body

            { ... }

    + Schema

            { ... }

## Retrieve an Account [GET]

+ Response 200

    [Account][]


## Update an Account [PUT]

+ Request

    [Account][]

+ Response 204