openapi - OpenAPI 仅获取一个路径的文档？

Question

我正在使用 OpenAPI 记录 Microprofile 应用程序。由于端点包含大量方法，我想知道是否可以通过 /openapi REST 进行过滤，以便它只返回一个特定的路径，例如“/users”。谢谢

Answer 1

您可以选择多个路径。在 openapi 文件中，整个路径部分称为“路径”（因此即使名称也是复数）。如果您不确定如何使用它，请在 Swagger 门户的“搜索”部分浏览 openapi（您需要为此登录）。

例子：

paths: 
  /{users}:
    options:
      security:
      summary: "Temp summary"
      description: "Temp description"
      tags: 
        - "TAG"
      parameters:
..
  /test/{table}:
    options:
      security:
      summary: "Temp summary"
      description: "Temp description"
      tags: 
        - "TAG"
      parameters:
..
  /test2/user/{id}:
    options:
      security:
      summary: "Temp summary"
      description: "Temp description"
      tags: 
        - "TAG"
      parameters: