MS OAuth2 API 文档

API 基础地址: https://mail.150420.xyz

            新功能: API 现在支持自动提取 6 位数字验证码！所有邮件 API 都会在响应中包含 verification_code 字段。
        

📧 获取最新一封邮件

获取指定邮箱文件夹中的最新邮件，自动提取验证码

GET /api/mail-new

参数名	类型	必需	说明
refresh_token	string	是	OAuth2 刷新令牌
client_id	string	是	微软应用客户端 ID
email	string	是	邮箱地址
mailbox	string	是	邮箱文件夹 (INBOX 或 Junk)
password	string	否	API 访问密码 (如果设置了环境变量)
response_type	string	否	返回格式 (json 或 html，默认 json)

调用示例:

                    
curl "https://mail.150420.xyz/api/mail-new?refresh_token=YOUR_TOKEN&client_id=YOUR_CLIENT_ID&email=your@email.com&mailbox=INBOX&password=YOUR_PASSWORD"

响应示例:

{
  "send": "\"KlingAI\" ",
  "subject": "KlingAI Account Verification",
  "text": "您是KlingAI的验证码...",
  "html": "<div>验证码: 233645</div>",
  "date": "2025-12-01T09:58:25.000Z",
  "verification_code": "233645"
}

📂 获取全部邮件

获取指定邮箱文件夹中的所有邮件

GET /api/mail-all

参数名	类型	必需	说明
refresh_token	string	是	OAuth2 刷新令牌
client_id	string	是	微软应用客户端 ID
email	string	是	邮箱地址
mailbox	string	是	邮箱文件夹 (INBOX 或 Junk)
password	string	否	API 访问密码 (如果设置了环境变量)

调用示例:

                    
curl "https://mail.150420.xyz/api/mail-all?refresh_token=YOUR_TOKEN&client_id=YOUR_CLIENT_ID&email=your@email.com&mailbox=INBOX&password=YOUR_PASSWORD"

🗑️ 清空收件箱

清空指定的收件箱

GET /api/process-inbox

参数名	类型	必需	说明
refresh_token	string	是	OAuth2 刷新令牌
client_id	string	是	微软应用客户端 ID
email	string	是	邮箱地址
password	string	否	API 访问密码 (如果设置了环境变量)

🗑️ 清空垃圾箱

清空指定的垃圾箱

GET /api/process-junk

参数名	类型	必需	说明
refresh_token	string	是	OAuth2 刷新令牌
client_id	string	是	微软应用客户端 ID
email	string	是	邮箱地址
password	string	否	API 访问密码 (如果设置了环境变量)

✉️ 发送邮件

使用 OAuth2 发送邮件

GET /api/send-mail

参数名	类型	必需	说明
refresh_token	string	是	OAuth2 刷新令牌
client_id	string	是	微软应用客户端 ID
email	string	是	发件人邮箱地址
to	string	是	收件人邮箱地址
subject	string	是	邮件主题
text	string	否	纯文本内容 (与 html 二选一)
html	string	否	HTML 内容 (与 text 二选一)
send_password	string	否	发送邮件密码 (如果设置了环境变量)

调用示例:

                    
curl "https://mail.150420.xyz/api/send-mail?refresh_token=YOUR_TOKEN&client_id=YOUR_CLIENT_ID&email=your@email.com&to=target@email.com&subject=测试邮件&text=这是测试内容&send_password=YOUR_PASSWORD"

🔧 环境变量配置

部署到 Vercel 时需要设置的环境变量

变量名	说明	示例值
PASSWORD	邮件读取 API 访问密码	your_read_password_123
SEND_PASSWORD	邮件发送 API 访问密码	your_send_password_456

                    注意: 如果不设置环境变量，API 将在没有密码验证的情况下工作。为了安全起见，建议设置密码保护。
                

📋 响应格式说明

API 响应数据格式

成功响应:

{
  "send": "发件人邮箱",
  "subject": "邮件主题",
  "text": "纯文本内容",
  "html": "HTML内容",
  "date": "2025-12-01T09:58:25.000Z",
  "verification_code": "123456"  // 如果邮件中包含6位数字验证码
}

错误响应:

                    
{
  "error": "错误描述信息"
}