在swagger中创建节

我正在写一个招摇过市的规范，我有三个独立的端点。在文档中如何将它们分开？我想在示例：用户、帖子和其他之间有一个明确的区别。因此，每一个都会有一个CRUD描述，并显示在swagger UI中，看起来像：

USERS
// user specs

POST
// post specs

OTHER
// other specs

---

您需要使用标记来实现这一点

因此，在“路径”对象上，对所有路由进行排序，并在每个路由上添加一个“标记”：[“{resource}”]，它应该在其中分组

例如：

"paths": {
    "/users": {
        "get": {
            "tags": ["User"],
            "description": "...",
        },
        "post": {
            "tags": ["User"],
            "description": "...",
        }
    },

    "/posts": {
        "get": {
            "tags": ["Post"],
            "description": "...",
        },
        "post": {
            "tags": ["Post"],
            "description": "...",
        }
    },

    "/other": {
        "get": {
            "tags": ["Other"],
            "description": "...",
        },
        "post": {
            "tags": ["Other"],
            "description": "...",
        }
    },
}

---

这在文档中一点也不明显。实际上，文档非常完整，但缺少索引和一些组织。

谢谢MWM！干杯。我们在V3中添加了一个目录：-）