✉

邮箱验证码

输入邮箱地址，查看最近收件与验证码

等待查询

三个接口，都是 GET，返回 JSON，无需登录（若站点开了访问码，见第 4 节）。

1. 只取最新验证码（最常用）

curl "https://youxiang.aicopy.cc/api/code?email=abc123@012e.com"

{
  "ok": true,
  "email": "abc123@012e.com",
  "code": "781617",
  "codes": ["781617"],
  "subject": "个人 Microsoft 帐户安全代码",
  "date": "2026-10-01T08:17:47.000Z",
  "from": "Microsoft 帐户团队 <account-security-noreply@accountprotection.microsoft.com>"
}

直接取 code 字段即可。还没收到验证码时 code 为 null，稍等几秒重试。

2. 取最近邮件（含正文）

curl "https://youxiang.aicopy.cc/api/mailbox?email=abc123@012e.com"

messages[] 里每封邮件包含：subject 主题、from 发件人、date 时间、 codes 自动提取的验证码数组（可能多个）、link 邮件里的验证按钮链接、text 纯文本正文。默认最多 12 封、按时间倒序。加 &refresh=1 可跳过 60 秒缓存强制拉最新。

3. 查这个邮箱能不能用（不连邮件服务器，秒回）

curl "https://youxiang.aicopy.cc/api/check?email=abc123@012e.com"
# {"ok":true,"exists":true,"enabled":true}

4. 如果站点启用了访问码

在任意接口 URL 后加 &k=访问码，或加请求头 X-Access-Key: 访问码：

curl "https://youxiang.aicopy.cc/api/code?email=abc123@012e.com&k=你的访问码"
curl -H "X-Access-Key: 你的访问码" "https://youxiang.aicopy.cc/api/code?email=abc123@012e.com"

5. 代码示例

// JavaScript / Node
const r = await fetch('https://youxiang.aicopy.cc/api/code?email=abc123@012e.com');
const j = await r.json();
if (j.code) console.log('验证码:', j.code);

# Python
import requests
j = requests.get('https://youxiang.aicopy.cc/api/code',
                 params={'email': 'abc123@012e.com'}, timeout=30).json()
print(j.get('code'))

6. 返回码与限制

200 成功・ 404 邮箱不在可用列表・ 403 邮箱已停用・ 429 请求太频繁（单 IP 每分钟约 30~40 次）・ 502 邮件服务器超时，重试即可。

同一邮箱 60 秒内重复请求走缓存，返回很快；首次读取需要连邮件服务器，通常 1~3 秒。接口只返回邮件内容，任何情况下都不会返回邮箱密码。