swagger - RAML 资源类型和特征 VS Swagger $ref

Question

我真的很喜欢 RAML 如何通过使用 ResourceTypes 和 Traits 专注于减少重复量并提高 API 之间的一致性。

但是在仔细查看 Swagger 规范后，您似乎可以通过使用 $ref 来完成同样的事情。

在这种情况下，RAML 比 $ref 有优势吗？我错过了什么吗？

Answer 1

在我对此进行了更多研究之后，我对它的工作原理有了更好的了解。

一个很大的区别是 RAML 中的 ResourceTypes 接受参数，这使得可以提取更多代码。

此外，您可以在 swagger 中使用 $ref 的地方是有限的。这意味着，您不能在资源级别或 http 方法上应用 $ref。您可以外部化的事物示例包括参数、响应和模型。

ResourceTypes 和 Traits 在将 REST 中的常见模式外部化并在不同服务中重用它们方面更强大