apiary - 如何在 Apiary 中重用 RESPONSE

Question

有没有办法在 Apiary 中重用响应？我认为数据结构不是正确的方法，但我找不到其他任何东西......

Answer 1

数据结构——您可能已经注意到，乍一看有点矫枉过正，但它正是您正在寻找的确切答案。如果您对如何在“高级模式”中使用它们更感兴趣，请查看https://github.com/apiaryio/api-blueprint/blob/master/Advanced%20Tutorial.md#data-上的教程结构

另一种选择是使用资源模型：

## My Message [/message]

+ Model (application/vnd.siren+json)

    This is the `application/vnd.siren+json` message resource representation.

    + Headers

            Location: http://api.acme.com/message

    + Body

            {
              "class": [ "message" ],
              "properties": {
                    "message": "Hello World!"
              },
              "links": [
                    { "rel": "self" , "href": "/message" }
              ]
            }

我们使用普通属性的另一个选项（https://github.com/apiaryio/api-blueprint/blob/master/API%20Blueprint%20Specification.md#resource-attributes-description）

# Blog Post [/posts/{id}]
Resource representing **ACME Blog** posts.

+ Attributes
    + id (number)
    + message (string) - The blog post article
    + author: john@appleseed.com (string) - Author of the blog post

稍后参考^^^“资产”，如下所示：

+ Attributes (Blog Post)