是否可以从另一个OpenAPI文件引用服务器对象?

时间:2018-04-06 09:39:57

标签: swagger-ui openapi

我正在使用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显示"无法渲染此组件"错误。

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

1 个答案:

答案 0 :(得分:0)

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

您可以在此处提交功能请求:
https://github.com/OAI/OpenAPI-Specification/issues