将资源模型重用为数组

Question

我正在记录API，我有2个非常相似的回复。

其中一个是call / resource / {id}。 此响应返回资源模型。

另一个调用是/ resource / search {？name，category}，它返回一个资源列表，所以我需要返回一个资源模型的数组。

我无法找到能否这样做。在蓝图文档中有关于Gists的类似内容。但是有两个模型Gist和Gist Collection。

我希望我解释了自己。

Answer 1

不幸的是，此时您无法引用另一个有效负载。这样做的原因是有效负载（模型，请求或响应）对API蓝图解析器是不透明的（因此您不必在其中转义任何内容）。

有计划解决这一需求并在未来使蓝图更加干燥 - 请参阅Embedded Assets和Traits里程碑。