В Swagger, как мне указать несколько хостов?

Question

Могу ли я использовать несколько хостов, как:

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

Сейчас мой файл YAML имеет только один хост URL.

например:

host: petstore.test.com 
basePath:/

Answer 1

OpenAPI/Форс 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 
    description: Development server 
    templates: 
     scheme: 
     enum: 
      - http 
      - https 
     default: https