在swagger中用http方法分组endpoint

Question

我有多个控制器，每个都有GET，POST，PUT，DELETE API。默认情况下，在控制器级别对API进行大摇大摆的分组。在swagger文档中，有没有什么方法可以按http方法类型对这些API进行分组？即一起获取API，一起发布API等。

Answer 1

您可以在定义的每个api路径级别上使用“tags”部分。这就是您如何在swagger中标记API路径的方法，如下所示。

paths:
  /pet:
    post:
      tags:   // This is where you provide your method type to group all your APIs for a given http method . Same you can do to tag "GET" methods .
      - "POST"
      summary: "Add a new pet to the store"
      description: ""
      operationId: "addPet"

对于所有的get API，您可以提供标记为“get”，对于post API，可以提供“post”等等。我为你建立了一个例子，它可能会帮助你形象化。