Question

我正在使用OpenAPI 3.0记录API列表，并为每个API记录单独的YAML文件。

所有API都使用相同的目标服务器，因此目前我在每个API定义中都有以下内容：

...
servers:
  - url: www.abc.com   
    description: "Production Server"

但我不想在所有API定义中重复servers。相反，我想从单个文件中引用servers，如下所示：

# sample.yaml
...
servers:
  $ref: 'index.yaml#/servers'

但Swagger UI显示＆＃34;无法渲染此组件＆＃34;错误。

OpenAPI 3.0定义中$ref是否可以servers？

Answer 1

OpenAPI 3.0规范不支持$ref中的servers。