Swagger 分离开放式API文档

在我的新后端API中，我有很多模型和操作，我希望记录它们

我目前正在使用开放式API文档标准

现在，将所有规范文件保存在一个巨大的

swagger.yaml

文件中有点像立方体

我现在的问题是，我是否可以将文档文件分成几个单元，例如

客户的所有操作进入

customer.yaml

商户的所有操作转到内部

商户。yaml

---

然后将

customer.yaml

和

merchants.yaml

合并成一个巨大的

swagger.yaml

文件，该文件将导出为API的文档文件当然，您可以使用（查找“远程参考”）。例如，您可以将巨大的yaml文件分解为较小的文件。然后您将得到一个主文件，其中包括远程文件。

是的，这就是我试图做的，但$ref似乎不接受文件路径数组。它只接受一个文件路径，这有点奇怪。没错，不能列出$ref。但是，可能有一个解决方法，这取决于您尝试执行的操作：您可以引用对象的每个属性，或者在被引用对象内使用引用。然而，也许我不完全理解这个问题？也许一个示例文件会有所帮助？