如何使用$ref引用另一个OpenAPI文件中的路径

Question

这里说我可以引用另一个文件中的定义作为单个路径，但这个例子似乎引用了整个文件，而不是paths对象下的单个路径定义。如何在另一个文件的paths对象中分配单个路径？

例如，我有包含/a/b路径的Anotherfile.yaml：

paths:
/a/b:
post:

在另一个文件中，我使用$ref引用/a/b路径，如下所示：

paths:
/c/d:
$ref: 'Anotherfile.yaml#/paths/a/b'

但这给出了一个错误：

在的内容中找不到路径/a/b/Anotherfile.yaml

Answer 1

引用路径时，需要通过将/替换为~1来转义路径名，使/a/b变为~1a~1b。请注意，您只转义路径名，而不转义#/paths/前缀。

$ref: 'Anotherfile.yaml#/paths/~1a~1b'