API文档生成器：让文档编写自动化

输入代码

// 用户登录接口
@PostMapping("/api/auth/login")
public ResponseEntity<?> login(@RequestBody LoginRequest request) {
    // 验证用户名密码
    if (!authService.validate(request.getUsername(), request.getPassword())) {
        return ResponseEntity.status(401).body(new ErrorResponse("Invalid credentials"));
    }
    
    // 生成token
    String token = jwtService.generateToken(request.getUsername());
    
    return ResponseEntity.ok(new LoginResponse(token, 3600));
}

// 请求体
class LoginRequest {
    private String username;  // 用户名
    private String password;  // 密码
}

// 响应体
class LoginResponse {
    private String token;     // 访问令牌
    private int expiresIn;   // 过期时间（秒）
}

生成的文档

// 成功响应 200
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "expiresIn": 3600
}

// 失败响应 401
{
  "error": "Invalid credentials"
}