Mail Retrieval Platform

把邮箱取件，做成一条可编排的接口流水线

令牌刷新、邮件拉取、指定序号读取、清空回收站——统一为一组稳定的 HTTP 接口。支持 OAuth2、IMAP 密码与 Microsoft Graph 三种接入方式，可批量调度，也可单条调试。

3接入通道

20+可用接口

2邮箱文件夹

1000并发压测通过

GET /api/oauth2/mail-latest

# 取最新一封邮件
curl "https://your-domain/api/oauth2/mail-latest" \
  -G \
  --data-urlencode "email=user@outlook.com" \
  --data-urlencode "client_id=xxxxxxxx" \
  --data-urlencode "refresh_token=M.C5..."

200 OK · application/json

{
  "success": true,
  "mail": {
    "subject": "您的验证码",
    "from": "noreply@service.com",
    "content": "验证码 482913，5 分钟内有效"
  },
  "total_count": 12
}

平均响应 320ms 支持 GET / POST JSON 返回

三条通道，一套协议

按账号形态选择接入方式，接口字段保持一致。

CHANNEL / 01

OAuth2 + XOAUTH2

使用 client_id 与 refresh_token 换取访问令牌，通过 IMAP XOAUTH2 读取收件箱与垃圾箱，适合长期维护的账号池。

CHANNEL / 02

IMAP 密码登录

直接以邮箱与应用密码登录任意 IMAP 服务器，支持自定义 host 与 SSL 开关，适合非微软系邮箱。

CHANNEL / 03

Microsoft Graph

走 REST 接口读取邮件与计数，不依赖长连接，在网络受限或需要边缘部署时更稳定。

接口一览

统一返回 JSON，错误包含 success 与 error 字段。

完整参数说明 →

路径	方法	用途
/api/oauth2/mail-latest	GET	获取指定邮箱最新一封邮件
/api/oauth2/mail-by-index	GET	按序号读取邮件，1 为最早一封
/api/oauth2/mail-count	GET	统计收件箱或垃圾箱邮件数量
/api/oauth2/clear-mails	POST	清空指定文件夹全部邮件
/api/graph/mail-all	GET	分页拉取邮件列表，最多 500 封
/api/imap/fetch-emails	POST	密码登录方式批量取件
/api/admin/accounts/import	POST	批量导入账号，异步返回任务 ID

接入只需要三步

不需要 SDK，标准 HTTP 客户端即可。

STEP / 01

准备凭据

准备邮箱、client_id 与 refresh_token；或直接在管理后台上传账号文件，由系统统一维护。

STEP / 02

调用接口

按需选择 OAuth2、IMAP 或 Graph 通道，传入 email 与凭据即可获取结构化邮件数据。

STEP / 03

处理结果

响应包含 subject、from、content 与全文 HTML，直接提取验证码或正文内容。