swagger - OpenAPI 3 中的参数重用

Question

这个问题在这里已经有了答案:





How to group multiple parameters in Swagger 2.0?

(2 个回答)


去年关闭。




在 OpenAPI v3 中定义 API 时，如果多个 API 路径使用相同的查询参数列表，是否可以定义一次并从每个路径引用它们？
想象一个常见的场景，我有 5 个不同的 API 用于搜索，但它们都共享相同的查询参数，例如“限制、书签、页面、排序”等。
对可能重复的回应
我不是要求一次引用 1 个特定参数，而是在多个 API 路径中重复使用一组参数。因此我不认为它是 How to define global parameters in OpenAPI? 的副本。 )

Answer 1

如果您希望所有通用参数都包含在 YAML 规范中的一行中，就规范本身而言，这似乎是不可能的。
Springdoc(用于 Java)等框架提供了一个 OperationCustomizer可以实现这些功能的接口(interface)。