openapi - 如何使用 $ref 从另一个 OpenAPI 文件引用路径？

Question

Here它说我可以引用另一个文件中单个路径的定义，但该示例似乎引用了整个文件，而不是 paths 下的单个路径定义。目的。如何在另一个文件的 paths 中分配单个路径目的？

例如，我有 Anotherfile.yaml包含 /a/b小路:

paths:
  /a/b:
    post:

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

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

但这给出了一个错误:

Could not find paths/a/b in contents of ./Anotherfile.yaml

Answer 1

引用路径时，需要escape the path name通过替换 /与 ~1 ，所以 /a/b变成 ~1a~1b .请注意，您只转义路径名而不是 #/paths/字首。

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