Skip to content

临时邮箱 ​

一键生成一次性邮箱地址,用来接收验证码、测试注册流程,避免暴露常用邮箱。这是全站唯一需要多步调用的接口:create → list → read。

  • 接口路径:/Interface/TempMail/
  • 方法:GET
  • 费用:免费
  • 本站限流:单 IP 每分钟 20 次

数据来源

上游为 mail.tm,真实收信。域名池会轮换,所以返回的邮箱后缀不固定(例如 fldubai.com),不要硬编码。上游单 IP 限 8 QPS,遇到繁忙时本站会退避重试一次,仍失败则返回 429。

真实返回 ​

浏览器直接打开 https://api.sco1.cn/Interface/TempMail/ 就能看到创建结果:

临时邮箱创建接口的真实返回

四步用法 ​

1、创建邮箱 ​

bash
curl "https://api.sco1.cn/Interface/TempMail/"
# 等价于 ?action=create
json
{
  "success": true,
  "code": 200,
  "message": "临时邮箱创建成功",
  "data": {
    "email": "tm98ad429723@fldubai.com",
    "token": "617deff2b947a6e5",
    "expires_in": 3600,
    "provider": "mail.tm",
    "source_url": "https://mail.tm",
    "next": {
      "list": "/Interface/TempMail/?action=list&token=617deff2b947a6e5",
      "read": "/Interface/TempMail/?action=read&token=617deff2b947a6e5&id={邮件ID}"
    }
  }
}

把 email 填到需要收验证码的网站,记住 token。上游账号凭据由本站 Redis 托管,调用方不需要保存账号密码,也不会看到上游 JWT。

2、查收件箱 ​

bash
curl "https://api.sco1.cn/Interface/TempMail/?action=list&token=617deff2b947a6e5"
json
{
  "success": true,
  "code": 200,
  "message": "获取成功",
  "data": {
    "email": "tm98ad429723@fldubai.com",
    "count": 1,
    "list": [
      {
        "id": "6af83a7ff4e9cf39bb0e7d54",
        "from": "noreply@example.com",
        "from_name": "Example",
        "subject": "您的验证码",
        "intro": "本次验证码为 482913,10 分钟内有效。",
        "date": "2026-11-14T10:39:59+00:00",
        "seen": false,
        "has_attachment": false
      }
    ]
  }
}

刚创建时 count 通常是 0,邮件到达需要几秒,请轮询而不是只查一次。

3、读取正文 ​

bash
curl "https://api.sco1.cn/Interface/TempMail/?action=read&token=617deff2b947a6e5&id=6af83a7ff4e9cf39bb0e7d54"

返回 text(纯文本)、html(HTML 正文)和 attachments(附件列表:id / filename / size)。读取时会自动把邮件标记为已读。

4、删除邮件(可选) ​

bash
curl "https://api.sco1.cn/Interface/TempMail/?action=delete&token=617deff2b947a6e5&id=6af83a7ff4e9cf39bb0e7d54"

参数 ​

参数类型必填说明
actionstring否create(默认)/ list / read / delete
tokenstring条件create 返回的 16 位字符串;list / read / delete 必填
idstring条件邮件 ID,取自 list[].id;read / delete 必填

key 参数

参数表里没有 key,它是全站通用身份参数。当前该接口免费且未启用强制 Key,详见 鉴权与 API Key。

完整示例:自动取验证码 ​

js
async function getCode() {
  const base = 'https://api.sco1.cn/Interface/TempMail/'

  const { data } = await fetch(base).then(r => r.json())
  console.log('临时邮箱:', data.email)

  // 把 data.email 填进目标网站后,轮询收件箱
  for (let i = 0; i < 20; i++) {
    await new Promise(r => setTimeout(r, 3000))
    const box = await fetch(`${base}?action=list&token=${data.token}`).then(r => r.json())
    if (box.data.count > 0) {
      const mail = await fetch(
        `${base}?action=read&token=${data.token}&id=${box.data.list[0].id}`
      ).then(r => r.json())
      const m = mail.data.text.match(/\b\d{6}\b/)
      if (m) return m[0]
    }
  }
  throw new Error('等待邮件超时')
}
python
import re, time, requests

base = 'https://api.sco1.cn/Interface/TempMail/'
box = requests.get(base, timeout=15).json()['data']
print('临时邮箱:', box['email'])

for _ in range(20):
    time.sleep(3)
    inbox = requests.get(base, params={'action': 'list', 'token': box['token']}, timeout=15).json()
    for mail in inbox['data']['list']:
        body = requests.get(base, params={
            'action': 'read', 'token': box['token'], 'id': mail['id']
        }, timeout=15).json()['data']['text']
        code = re.search(r'\b\d{6}\b', body)
        if code:
            print('验证码:', code.group())
            raise SystemExit

错误码 ​

code含义处理
400action 非法、缺 token / id、token 格式不对核对参数
401token 无效或超过 1 小时重新 create,旧邮箱作废
404邮件 ID 不存在或已被删除 / 上游已清理重新 list 取最新 ID
429本站 20 次/分限流,或上游 8 QPS 繁忙退避后重试,不要死循环
502上游域名池、建号、鉴权或读信失败稍后重试
503本站 Redis 会话存储不可用稍后重试

限制与注意 ​

  • token 有效期 1 小时,过期需重新 create;上游邮箱本身也可能被回收。
  • 不要公开分享 token:拿到它的人能读你这个邮箱的所有邮件。
  • 临时邮箱不保证隐私和长期可用性,不要用来接收重要账号的邮件。
  • 上游域名池会轮换,且单 IP 有 8 QPS 限制;短时间高频 create 可能撞限流。
  • 请勿用于批量注册、发送垃圾邮件或任何违法用途。

站内详情页同样提供在线调试面板,可直接选 action 试调:

接口详情页的在线调试面板

接口数据实时读取自站点数据库