将资源模型作为数组重用

Question

我正在记录一个 API，我有 2 个非常相似的响应。

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

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

我不知道我是否可以这样做。在蓝图文档中有关于 Gists 的类似内容。但是有两个模型 Gist 和 Gist Collection。

我希望我能解释一下自己。

Answer 1

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

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