Swagger 为定义的招摇过市路线提供备用(国际)拼写

Swagger 为定义的招摇过市路线提供备用(国际)拼写,swagger,swagger-2.0,Swagger,Swagger 2.0,我正在swagger中编写一个API规范,它有一个端点: /authorizations 我也想为这个端点定义一个替代的拼写授权。这可能吗?或者我需要为每个拼写定义单独的路线吗 /authorizations: get: description: Returns a list of authorizations Swagger当前不支持重载/别名路径定义。我不记得曾经见过这样的请求,但如果您在未来的版本中要求添加对它的支持,您将非常欢迎。Swagger目前不支持重载/别名

我正在swagger中编写一个API规范,它有一个端点:

/authorizations
我也想为这个端点定义一个替代的拼写授权。这可能吗?或者我需要为每个拼写定义单独的路线吗

/authorizations:
    get:
      description: Returns a list of authorizations

Swagger当前不支持重载/别名路径定义。我不记得曾经见过这样的请求,但如果您在未来的版本中要求添加对它的支持,您将非常欢迎。Swagger目前不支持重载/别名路径定义。我不记得曾经见过这样的请求,但如果您在将来的版本中请求添加对它的支持,那么您将遇到一个问题。一个可能的解决方法是定义另一个路径,这样您将得到同一路径的两个副本

路径: /授权: 获取: 描述:返回授权列表 响应: 200: 描述:好的 /授权: $ref:“/path/~1授权” 这种技术的一个限制是,您不能为这些路径设置operationId,因为两条路径都将以相同的ID结束,这是不允许的


如果您需要在路径中使用不同的operationId,则需要以通常的方式定义第二条路径,即从第一条路径复制粘贴定义。

一种可能的解决方法是定义另一条路径,这样您将得到同一路径的两个副本

路径: /授权: 获取: 描述:返回授权列表 响应: 200: 描述:好的 /授权: $ref:“/path/~1授权” 这种技术的一个限制是,您不能为这些路径设置operationId,因为两条路径都将以相同的ID结束,这是不允许的

如果需要在路径中使用不同的operationId,则需要以通常的方式定义第二个路径,即从第一个路径复制粘贴定义。

请参阅其中一个建议,即使用308重定向定义重命名的路径:

  /original-x:
    description: Redirects to the new X
    get:
      responses:
        '308':
          description: This resource has been moved
          headers:
            Location:
              schema:
                type: string
                default: /new-x
我还没有看到另一种干净地实现此功能的方法。

请参阅其中的一个建议,即使用308重定向定义重命名的路径:

  /original-x:
    description: Redirects to the new X
    get:
      responses:
        '308':
          description: This resource has been moved
          headers:
            Location:
              schema:
                type: string
                default: /new-x
我还没有看到另一种干净地实现这一点的方法