2

阅读API Blueprint specification,似乎设置为允许指定“数据结构”,例如:

  • 地址
    • 街道:100 Main Str. (字符串) - 街道地址
    • 邮编:77777-7777(字符串)-邮政编码

...

  • 顾客:
    • 句柄:mrchirpy(字符串)
    • 地址:(地址)

然后在模型中,引用数据结构:

  • 模型

    [顾客][]

似乎一切都设置为通过引用数据结构,它应该生成与端点一致的文档和示例。

但是,我似乎无法让它工作,也找不到使用“完全规范化数据抽象”的示例。我想定义一次我的数据结构,然后到处引用。看起来这可能是工具的问题,特别是我使用aglio作为渲染代理。

似乎所有这些都是折叠类型的东西,所以我很困惑,想知道我是否遗漏了一些东西,或者对这里可能发生的事情做出了错误的假设。

4

1 回答 1

0

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

于 2015-04-21T20:45:39.983 回答