OpenAPI3.0允许引用服务器变量吗？

Question

假设我的OpenAPI定义有两个服务器。两者共享相同的变量。因此，我想引用这些变量来防止重复代码。

openapi: 3.0.2
info:
  title: My API
  description: 'some description'
  version: 1.0.0
servers:
  - url: 'https://stage-api.domain.com/foo/{v1}/{v2}/{v3}'
    description: Staging API server for QA
    variables:
      v1:
        description: 'variable 1'
        default: 'something'
        enum:
          - 'foo1'
          - 'foo2'
      v2:
        description: 'variable 2'
        default: 'something'
        enum:
          - 'foo1'
          - 'foo2'
      v3:
        description: 'variable 3'
        default: 'something'
        enum:
          - 'foo1'
          - 'foo2'
  - url: 'https://api.domain.com/foo/{v1}/{v2}/{v3}'
    description: PRODUCTION API server
    variables:
      region:
        $ref: '#/servers/0/variables/v1'
      brand:
        $ref: '#/servers/0/variables/v2'
      locale:
        $ref: '#/servers/0/variables/v3'
paths: {}

是否可以引用服务器变量或以另一种方式重用它们？

当然，我可以运行swagger-cli bundle-r，但我不想使用它。

Answer 1

不，不支持此操作。您可以在
https://github.com/oai/openapi-specification/isputions请求更改OpenAPI规范

在您的示例中，除了子域之外，服务器路径几乎相同，因此可以使用单个服务器定义并将子域设置为变量：

servers:
  - url: 'https://{env}.domain.com/foo/{v1}/{v2}/{v3}'
    variables:
      env:
        description: Environment - staging or production
        default: stage-api
        enum:
          - stage-api
          - api
      # other variables
      # ...