微软邮箱批量管理系统

API接口文档

获取验证码

URL: /api?email={邮箱地址}

方法: GET

参数:

  • email (必需): 要查询的邮箱地址

响应示例:

{
    "success": true,
    "data": {
        "code": "123456",
        "sender": "noreply@tiktok.com",
        "subject": "Your verification code",
        "received_time": "2025-09-09 14:30:15"
    },
    "message": "成功获取验证码"
}

健康检查

URL: /api/health

方法: GET

说明: 检查API服务状态

响应示例:

{
    "success": true,
    "message": "API服务正常运行",
    "timestamp": "2025-09-09T14:30:15.123456"
}

缓存状态查看

URL: /api/cache

方法: GET

说明: 查看当前客户端缓存状态

响应示例:

{
    "success": true,
    "cache_count": 2,
    "cached_clients": [
        {
            "email": "test@outlook.com",
            "remaining_seconds": 485,
            "is_expired": false
        }
    ],
    "message": "当前缓存了 2 个客户端"
}

清空缓存

URL: /api/cache/clear

方法: POST

说明: 清空所有缓存的客户端连接

响应示例:

{
    "success": true,
    "message": "已清空 2 个缓存的客户端"
}

缓存机制说明

  • 客户端登录后会被缓存10分钟
  • 10分钟内重复请求同一邮箱将使用缓存的客户端，避免重复登录
  • 缓存过期后会自动清理
  • 可以通过 /api/cache 查看当前缓存状态
  • 可以通过 /api/cache/clear 手动清空所有缓存

注意事项

  • 只会处理来自 @tiktok.com 的邮件
  • 只返回最近1分钟内收到的验证码
  • 验证码提取规则支持多种格式：HTML标签、邮件主题、纯文本
  • 所有邮件记录会保存到数据库中