OpenAPI 3中的参数重用

Question

在OpenAPI v3中定义接口时，如果多个接口路径使用相同的查询参数列表，有没有办法一次定义它们并在每个路径中引用它们？

想象一下一个常见的场景，我有5个不同的API用于搜索，但它们都共享相同的查询参数，如“限制、书签、页面、排序”等。

对可能的重复项的响应

我问的不是一次引用一个特定的参数，而是在几个API路径中重用一组参数。因此，我不认为它是How to define global parameters in OpenAPI?的复制品)

Answer 1

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