是否可以在OpenApi 3中创建特定于环境的路径？

Question

我的目标：

我正在应用程序中处理一组endpoint，我有一个包含所有endpoint的swagger 2.0文件。他们正在我们的测试环境中工作，但我们还不会在prod中提供他们。

我的问题是：

如果我升级到OpenApi 3，是否可以通过服务器对象隐藏我不希望在prod中可见的路径？

我不认为这是因为阅读了文档，但我很想在这里出错，因为我更希望只有一个api。yml，而不是每个环境一个。

非常感谢。

Answer 1

我做了一些测试，结果是否定的。

• 您可以选择用户可以运行“试用”测试的服务器。这是一个很棒的功能

下面是我在在线编辑器中使用的OpenAPI yaml进行验证。我在这里使用了在线编辑器：Swagger Editor，并使用OpenAPI-规范github存储库中提供的petstore.yaml示例作为起点。我删除了除一个endpoint以外的所有endpoint以缩短内容。如果您正在启动一个开放的api文档，我建议您访问OpenAPI或Swagger以查找留档和完整示例。

openapi: "3.0.0"
info:
version: 1.0.0
title: Swagger Petstore
description: Try to not show get when prod server is chosen
license:
    name: MIT
servers:
- url: http://prod      
- url: http://test
- url: http://dev
paths:
/pets:
    get:
    summary: List all pets
    operationId: listPets
    tags:
        - pets
    parameters:
        - name: limit
        in: query
        description: How many items to return at one time (max 100)
        required: false
        schema:
            type: integer
            format: int32
    servers: 
        - url: http://test
        - url: http://dev
    responses:
        200:
        description: An paged array of pets
        headers:
            x-next:
            description: A link to the next page of responses
            schema:
                type: string
        content:
            application/json:    
            schema:
                $ref: "#/components/schemas/Pets"
        default:
        description: unexpected error
        content:
            application/json:
            schema:
                $ref: "#/components/schemas/Error"

components:
schemas:
    Pet:
    required:
        - id
        - name
    properties:
        id:
        type: integer
        format: int64
        name:
        type: string
        tag:
        type: string
    Pets:
    type: array
    items:
        $ref: "#/components/schemas/Pet"
    Error:
    required:
        - code
        - message
    properties:
        code:
        type: integer
        format: int32
        message:
        type: string