markdown - 如何重用 API BluePrint 模式中的对象？

Question

我创建了一个 API，用于提供名为“Thumbnail”(/thumbnails) 的资源

{
    "name": "toto",
    "uri": "http://xxx"
}

另一方面，我有多个资源，其中包含缩略图资源(例如/articles、/videos ...):

{
    "name": "playlist",
    "thumbnail": 
    {
        "name": "toto",
        "uri": "http://xxx"
    }
}

当我在 BluePrint markdown 中编写这些 Web 服务的架构时，我希望能够重用为缩略图架构创建的架构，以免重复架构中的代码。我很喜欢 Trait 功能 ( https://github.com/apiaryio/api-blueprint/issues/47 )，但我不知道它是否能满足我的需求，以及是否可以与 aglio 和 dredd 一起使用。

您知道针对我的情况最好做什么吗？

Answer 1

您可以使用MSON在 Attributes API 蓝图的部分用于定义可重用对象。

您可以在 here 中看到一些示例, here和 here .