在Swagger中,如何指定多个主机?

时间:2016-11-14 07:16:13

标签: swagger

我可以使用多个主机,如:

host1: petstore.test.com
host2: petstore1.test.com
host3: petstore2.dev.com

现在我的YAML文件只有一个主机URL。

例如:

host: petstore.test.com
basePath: /

2 个答案:

答案 0 :(得分:9)

OpenAPI / Swagger 2.0仅支持具有多个方案的单个主机(HTTP / HTTPS /等),因此您可以有效地拥有两个仅在方案中有所不同的主机:

host: petstore.test.com
schemes:
  - http
  - https

最新版本OpenAPI 3.0支持具有不同方案和基本路径的multiple hosts

servers:
  - url: https://petstore.prd.com
    description: Production server

  - url: {scheme}://petstore.dev.com/subpath
    description: Development server
    templates:
      scheme:
        enum:
          - http
          - https
        default: https

答案 1 :(得分:0)

现在可以在OpenApi 3.0

这里是一个描述:

  

OpenAPI 3.0支持多个主机。 2.0仅支持一个   每个API规范的主机(如果您将HTTP和HTTPS视为两个,则为两个)   不同的主机)。定位多个主机的一种可能方法是忽略   规范中的主机和架构,并从每个规范中提供   主办。在这种情况下,规范的每个副本都将针对   相应的主机。