buff/backend/API_DEBUG_LOGGING.md

🎯 API调试日志说明

✅ 已添加详细的API出入参日志输出功能

📋 日志输出位置：

• 控制台输出（运行后端时可见）
• 日志文件：logs/app_*.log

🔍 日志内容包括：

1. [API请求] 原始请求数据

   • 显示客户端发送的原始加密数据
   • 显示解密后的JSON数据
   • 显示解析后的请求参数

2. [API请求] 解析后的请求

   • 操作类型、时间戳、版本信息
   • 关键业务参数（如用户名、机器码等）

3. [API响应] 响应数据

   • 响应状态码和消息
   • 响应数据大小
   • 完整的响应内容（加密前）

4. 业务逻辑日志

   • [用户登录] 用户名验证、密码检查
   • [用户登录] 机器码绑定/验证
   • [用户登录] 会话创建结果
   • [心跳检测] 用户心跳状态
   • [卡密激活] 激活参数和结果

🚀 使用方法：

1. 启动后端服务：python main.py
2. 客户端发起API请求
3. 查看控制台或日志文件中的详细日志

📊 日志级别：

• INFO: 重要业务操作
• DEBUG: 详细的请求/响应数据
• WARNING: 异常情况和警告
• ERROR: 错误和异常

示例日志输出： [API请求] 原始请求数据: {"encrypted": "...", "key_version": 5} [API请求] 解密后数据: {"action": "login", "params": {...}} [用户登录] 用户名: testuser, 机器码: ABC123 [用户登录] 登录成功 - 用户: testuser, SessionID: abc12345... [API响应] 响应数据 - 状态码: 200, 消息: 成功, 数据大小: 156 字符