我在这里挖来挖去,试图找到一个解决方案,如何将多个OpenApi v3组件定义合并到一个文件中。
让我们想象一下这样的情况。
blueprint.v1.yaml
). 通常情况下,我使用 swagger-cli
合并所有 $ref
依赖关系,但现在不是这样的情况,因为我不能引用整个 componentsschemas 对象列表。swagger-cli bundle
工具。因此,问题是--如何在我的 blueprint.v1.yaml
文件?
P.S. 每一个 components.v1.yaml
看起来像这样。
和一个,例如: location-create-single.v1.yaml
路径定义如下图所示。需要注意的是,所有 $ref
指的是 components.v1.yaml
文件。
我不认为有一个 "原生的 "OpenAPI解决方案来解决你的问题。人们已经讨论了一段时间关于OpenAPI覆盖扩展合并的问题。. 目前(2020-04-24)还没有任何关于这个话题的共识。
虽然你可以实现自己的工具 或使用现有的 来预处理您的 blueprint.v1.yaml
并产生 "合并的美洲国家组织".