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