邮件获取系统

1

配置邮箱

26

总邮件数

1

活跃缓存

30s

最快更新间隔

API接口使用说明
获取所有邮件
GET /api/emails?limit=100&cache=false

获取最新的100封邮件（cache=false实时获取）

搜索邮件
GET /api/search?keyword=关键词&limit=50&cache=false

在主题、发件人、内容中搜索关键词

获取最近邮件 新功能
GET /api/emails?cache=false&minutes=10&limit=50

获取最近10分钟内的邮件（支持1-1440分钟）

获取指定邮箱邮件
GET /api/emails/{邮箱ID}?limit=100&cache=false

获取特定邮箱的邮件

缓存控制参数
cache=true （默认）使用缓存，快速响应
cache=false 实时获取，确保最新数据

注意：实时获取速度较慢，建议合理使用

时间过滤参数 新功能
minutes=N 获取最近N分钟内的邮件

仅在cache=false时有效，适合实时监控场景

测试API 测试最近邮件
邮箱状态
邮箱地址 状态 邮件数量 最后更新 过滤条件
cui824723@88.com 正常 26 封 2025-12-15T02:16:35
主题 发件人 严格
支持的邮箱服务商
Gmail
QQ邮箱
163邮箱
126邮箱
Outlook
新浪邮箱
88完美邮箱
阿里云邮箱
API接口使用说明
基础接口
GET /api/emails

获取所有邮箱的邮件，支持参数：

  • limit - 限制返回邮件数量
  • cache - 是否使用缓存 (true/false)
  • minutes - 获取最近N分钟内的邮件（实时模式）
GET /api/emails/{邮箱标识}

获取指定邮箱的邮件，支持相同参数

GET /api/search

搜索邮件，支持参数：

  • q - 搜索关键词
  • type - 搜索类型 (subject/from/to/content)
  • mailbox - 指定邮箱
安全控制
IP访问控制

系统支持IP访问控制功能，管理员可以：

  • 启用/禁用IP访问控制
  • 设置IP白名单，只允许指定IP访问API
  • 支持单个IP和IP段（CIDR格式）
  • 可选择允许所有IP访问
注意： 如果启用IP控制且您的IP不在白名单中，API访问将被拒绝并返回403错误。
获取所有邮件
GET /api/emails?limit=100&cache=false

获取最新的100封邮件（cache=false实时获取）

搜索邮件
GET /api/search?keyword=关键词&limit=50&cache=false

在主题、发件人、内容中搜索关键词

获取最近邮件 新功能
GET /api/emails?cache=false&minutes=10&limit=50

获取最近10分钟内的邮件（支持1-1440分钟）

测试API 测试最近邮件