如何在OpenAPI (Swagger)中参数化API基本路径？

Question

我有一个这样的URL：

/id/{idnumber}/status

在这个URL中，/id/{idnumber}是API的基本路径，/status是资源。

我知道OpenAPI (Swagger)允许路径中的参数，如下所示：

paths:
  /id/{number}/status:

但这不是我需要的，因为/id/{idnumber}是基本路径，而不是资源路径的一部分。

有没有办法在基本路径中有一个参数？

host: my.api.com
basePath: /id/{idnumber}   # <---

paths:
  /status:

Answer 1

现在，OpenAPI 3.0支持使用服务器变量的参数化基本路径

openapi: 3.0.0
...

servers:
  - url: https://my.api.com/id/{number}
    variables:
      number:
        default: '-1'

请注意，服务器变量必须具有default值-如果客户端未提供值，则会使用该值。

有关详情，请参阅：

OpenAPI 3.0 Specification

• API Server and Base URL on swagger.io

中的

• Server Object和Server Variable Object部分

Answer 2

我不认为basePath允许变量。

对于您的情况，您不需要使用basePath。您可以简单地将/id/{idnumber}放在URL路径中。对于example

    "/pet/{petId}": {