如何在swagger open api中配置BASE_PATH？答案

【问题标题】：How to configure BASE_PATH in swagger open api?如何在swagger open api中配置BASE_PATH？
【发布时间】：2020-10-13 20:37:46
【问题描述】：

我正在努力寻找配置 BASE_PATH 的方法。

我要配置基本路径服务器端

我正在使用 open-api-generator 从一个 swagger 端点（asp 核心 web api）生成 subs

有没有办法配置不同的BASE_PATH。

【问题讨论】：

标签： swagger openapi openapi-generator

【解决方案1】：

如何定义基本 URL 取决于您所针对的 OpenAPI 规范版本。

Swagger/OpenAPI 2.0

在文档的根目录下定义host。对于example：

swagger: "2.0"
info:
  version: 1.0.0
  title: Swagger Petstore
  license:
    name: MIT
host: petstore.swagger.io
basePath: /v1
schemes:
  - http
consumes:
  - application/json
produces:
  - application/json
paths:
  /pets:
    …

OpenAPI 3.x

在文档根目录的servers 中定义一个URL。对于example：

openapi: "3.0.0"
info:
  version: 1.0.0
  title: Swagger Petstore
  license:
    name: MIT
servers:
  - url: http://petstore.swagger.io/v1
paths:
  /pets:
    …

【讨论】：

不确定如何在 .netcore web api 中定义它？请问有导游吗
这取决于您在 .netcore api 中使用的任何插件或扩展来生成 OpenAPI 文档。您必须查看该工具的文档以了解如何配置主机（如果您的文档是 2.0 版）或服务器（如果您的文档是 3.x 版）。