swagger - 如何在 OpenAPI (Swagger) 中为同一路径定义不同的查询参数?

标签 swagger openapi

我正在使用 Swagger Codegen 启动 REST 服务。我需要对不同的参数有不同的响应。

示例:<baseURL>/path可以使用?filter1=?filter2= ,并且这些参数应该产生不同的响应消息。

我希望我的 OpenAPI YAML 文件分别记录这两个查询参数。这可能吗?

最佳答案

它在 2.0 规范中不受支持,在 3.0 中也不支持。

以下是 OpenAPI 规范存储库中的相应提案:
Accommodate legacy APIs by allowing query parameters in the path
Querystring in Path Specification

关于swagger - 如何在 OpenAPI (Swagger) 中为同一路径定义不同的查询参数?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/40495880/

相关文章:

amazon-web-services - 将 OpenAPI 规范中描述的 REST API 转换为 Terraform 模板中描述的 AWS API Gateway REST API

dictionary - Swagger:<字符串,对象> 的映射

amazon-web-services - 当 lambda 和授权者返回 200 时,API 网关返回 500

java - 如何更改 Swagger UI 中的默认组/规范?

asp.net-core - ASP.Net Core Swagger如何忽略默认参数值

java - Spring boot 2.04 Jackson 无法将 LocalDateTime 序列化为 String

java - OpenAPI/Swagger-UI注释和@BeanParam

swagger - 如何使用 refs 在示例数组中放置多个项目 - Open API

c# - 使用 Swashbuckle Aspnetcore 将 `host` 、 `basePath` 和 `schemes` 添加到 swagger.json

amazon-web-services - 将 OpenAPI 组件与 AWS API Gateway 结合使用