要通过 tag 限制生成接口文档的范围,在 Swagger 注解中添加 @Tags 标签并在括号中指定要包含的标签即可。
例如,如果您有两组 API,一组标有 "users" 和 "authentication" 标签,另一组标有 "products" 和 "inventory" 标签,您可以使用以下代码限制只生成用户和身份验证相关的 API 的文档:
@Tags({"users", "authentication"})
如果要生成与产品和库存相关的API的文档,请使用以下代码:
@Tags({"products", "inventory"})
您甚至可以使用逗号分隔值指定多个标签,如下所示:
@Tags({"users", "authentication", "products"})
此外,您还可以在 Swagger UI 中使用左侧的标签选择器来过滤要显示的 API。