API Blueprint + Aglio 中的数据抽象？

Question

阅读 API Blueprint specification，似乎设置允许指定 'Data Structures'，如：

• 地址
  • 街道：100 Main Str. （字符串）- 街道地址
  • zip：77777-7777（字符串）- 邮政编码

...

• 客户：
  • 句柄：mrchirpy（字符串）
  • 地址：（地址）

然后在模型中，引用数据结构：

• 型号

  [客户][]

似乎所有设置都是通过引用数据结构来生成与端点一致的文档和示例。

但是，我似乎无法让它工作，也找不到使用 "fully normalized data abstraction" 的示例。我想一次定义我的数据结构，然后到处引用。看起来这可能是工具的问题，特别是我使用 aglio 作为渲染代理。

似乎所有这些都是折叠式内容的顶部，所以我很困惑，想知道我是否遗漏了什么或者对这里可能发生的事情做出了错误的假设。

Answer 1

@zanerock，我是 Aglio 的作者。您提到的数据结构支持是 MSON 的一部分，最近作为功能添加到 API Blueprint 以描述数据结构/模式。 Aglio 尚未更新以支持此功能，但我确实计划添加该功能。