openapi 3.0 响应模式中的变量

Question

我有一个遗留的 REST 端点，我想使用 openapi 3.0 来解决这个问题。

端点使用路径变量：

路径：

action/{action}s/

并且还在响应模式中使用此路径变量，例如：

json 中的响应：

{
  "name": "someName",
  "{action}": "someActionName",
  "{action}Id": 5
}

我在 openapi 指南中找不到关于这个的解释。是否可以根据此类请求生成 openapi 3.0 规范？

Answer 1

是的，所有版本的 OpenAPI 规范都支持部分段路径模板。