rest - 如何在 OpenAPI 3 中记录预先加载的对象

Question

我们有以下情况：在我们的 API 中，我们可以像这样急切地加载其他项目，/user?includes=projects这会导致嵌套响应

{
  "name": "John",
  ...
  "projects": [
    {
      "title": "Example"
      ... 
    }
  ]
}

如果我们调用没有包含的端点，/user则响应不包括项目

{
  "name": "John",
  ...
}

您将如何在 OpenAPI 3 中记录这一点？

标签： restopenapi