diff --git a/docs/api/api-documentation.md b/docs/api/api-documentation.md index 0c9f184..26171be 100644 --- a/docs/api/api-documentation.md +++ b/docs/api/api-documentation.md @@ -11,6 +11,8 @@ 3. **验证码有效期**: 所有验证码有效期为5分钟 4. **频率限制**: 验证码发送限制1次/分钟,注册限制10次/5分钟 5. **测试模式**: 开发环境下邮件服务返回206状态码,验证码在响应中返回 +6. **冷却时间自动清除**: 注册、密码重置、验证码登录成功后会自动清除验证码冷却时间,方便后续操作 +7. **邮件模板修复**: 登录验证码现在使用正确的邮件模板,内容为"登录验证码"而非"密码重置" ### 错误处理规范 - **409 Conflict**: 资源冲突(用户名、邮箱已存在) @@ -24,6 +26,7 @@ 2. 邮箱注册流程:先发送验证码 → 检查409冲突 → 使用验证码注册 3. 测试模式下验证码在响应中返回,生产环境需用户查收邮件 4. 实现重试机制处理429频率限制错误 +5. 注册/重置密码成功后,验证码冷却时间会自动清除,可立即发送新验证码 --- @@ -945,6 +948,11 @@ ## 📊 版本更新记录 +### v1.1.2 (2025-12-25) +- **验证码冷却优化**: 注册、密码重置、验证码登录成功后自动清除验证码冷却时间 +- **用户体验提升**: 成功操作后可立即发送新的验证码,无需等待冷却时间 +- **代码健壮性**: 冷却时间清除失败不影响主要业务流程 + ### v1.1.1 (2025-12-25) - **邮箱冲突检测优化**: 发送邮箱验证码前检查邮箱是否已被注册 - **用户体验提升**: 避免向已注册邮箱发送无用验证码 diff --git a/docs/api/openapi.yaml b/docs/api/openapi.yaml index 39ddfbb..7a4b7fd 100644 --- a/docs/api/openapi.yaml +++ b/docs/api/openapi.yaml @@ -1,8 +1,8 @@ openapi: 3.0.3 info: title: Pixel Game Server - Auth API - description: 像素游戏服务器用户认证API接口文档 - 包含验证码登录功能和邮箱冲突检测 - version: 1.1.1 + description: 像素游戏服务器用户认证API接口文档 - 包含验证码登录功能、邮箱冲突检测、验证码冷却优化和邮件模板修复 + version: 1.1.3 contact: name: API Support email: support@example.com @@ -489,7 +489,7 @@ paths: tags: - auth summary: 发送登录验证码 - description: 向用户邮箱或手机发送登录验证码 + description: 向用户邮箱或手机发送登录验证码。邮件内容使用专门的登录验证码模板,标题为"登录验证码",内容说明用于登录验证而非密码重置。 operationId: sendLoginVerificationCode requestBody: required: true