全球化 OpenAPI 中某些控制器名称的标签

如何解决全球化 OpenAPI 中某些控制器名称的标签

我在使用 OpenAPI 时遇到问题，所以我在这里寻求帮助。

我的问题是我有一个 .yml 文件来导入我的路由 and it looks like this

正如你所看到的，资产等人是默认的，我想要做的是给他们提供彼此分开的标签，所以it looks like this for example

所以我所做的是当有一个 GET 方法时，然后我给它一个标签：

  paths:
  "/persons/{person_id}/":
    get:
      tags:
        - Person
      summary: persons#index":

我在顶部定义了一个全局标签变量，如下所示：

tags:
  - name: Person
  - name: Asset

我的问题是我有超过 1000 行代码，我无法在每个 get 方法下手动编写这些代码行

有没有办法让它更容易？当您定义一个标签并传递应该属于该标签的所有内容时，我正在考虑这样的事情。

有点像这样：

tags:
  - name: Person
  paths:
     "/persons/{person_id}/load_autocomplete_parent":
      get:
      summary: persons#load_autocomplete_parent
    "/persons/load_autocomplete":
    get:
      summary: persons#load_autocomplete
  "/persons/load_name":
    get:
      summary: persons#load_name
  "/persons/tree":

谢谢

解决方法

这不是您要寻找的答案，但不，您不能这样做。

根据规范，您可以在两个地方使用 tags 字段：

• OpenAPI Object，文档的根，您可以在其中拥有一个规范使用的标签列表以及附加元数据，即全局标签你提到了。

• Operation Object，描述路径上的单个 API 操作。这就是您已经在单个端点中执行的操作。