在现代API开发中，Swagger已成为构建和文档化RESTful API的强大工具。通过Swagger，开发者可以轻松定义接口规范并生成交互式文档，提升协作效率。以下是一些常用的Swagger参数及其用法，助你快速上手！

🔍 @Api：用于标记Controller类，描述整个模块的功能。例如：

```java

@Api(value = "用户管理模块", description = "提供用户注册与登录功能")

public class UserController { ... }

```

📝 @ApiOperation：为每个方法添加详细说明。

```java

@ApiOperation(value = "获取用户信息", notes = "根据ID查询用户详情")

@GetMapping("/{id}")

public User getUser(@PathVariable Long id) { ... }

```

🔗 @ApiParam：为请求参数添加注释，方便前端理解。

```java

@ApiOperation("新增用户")

@PostMapping

public User createUser(

@ApiParam(name = "username", value = "用户名", required = true) @RequestParam String username,

@ApiParam(name = "age", value = "年龄", required = false) @RequestParam(defaultValue = "18") Integer age) { ... }

```

🎉 使用这些参数后，Swagger UI界面会自动生成直观的API文档，帮助团队高效沟通！💪✨