主题
临时邮箱
一键生成一次性邮箱地址,用来接收验证码、测试注册流程,避免暴露常用邮箱。这是全站唯一需要多步调用的接口: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=createjson
{
"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"参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | string | 否 | create(默认)/ list / read / delete |
token | string | 条件 | create 返回的 16 位字符串;list / read / delete 必填 |
id | string | 条件 | 邮件 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 | 含义 | 处理 |
|---|---|---|
| 400 | action 非法、缺 token / id、token 格式不对 | 核对参数 |
| 401 | token 无效或超过 1 小时 | 重新 create,旧邮箱作废 |
| 404 | 邮件 ID 不存在或已被删除 / 上游已清理 | 重新 list 取最新 ID |
| 429 | 本站 20 次/分限流,或上游 8 QPS 繁忙 | 退避后重试,不要死循环 |
| 502 | 上游域名池、建号、鉴权或读信失败 | 稍后重试 |
| 503 | 本站 Redis 会话存储不可用 | 稍后重试 |
限制与注意
- token 有效期 1 小时,过期需重新 create;上游邮箱本身也可能被回收。
- 不要公开分享 token:拿到它的人能读你这个邮箱的所有邮件。
- 临时邮箱不保证隐私和长期可用性,不要用来接收重要账号的邮件。
- 上游域名池会轮换,且单 IP 有 8 QPS 限制;短时间高频 create 可能撞限流。
- 请勿用于批量注册、发送垃圾邮件或任何违法用途。
站内详情页同样提供在线调试面板,可直接选 action 试调:
