用 HTTP 接口生成临时邮箱、收取邮件,把收信能力集成到你自己的脚本、测试流水线或机器人里。
https://www.mail0.vip
全部接口返回 JSON(附件下载除外)。游客可直接匿名调用;购买含 API 套餐的用户还可用 API Key 以账号身份调用(享对应套餐配额),见下方「API Key 认证」。
不携带 Key 时按游客匿名调用,生成 / 读取临时邮箱完全免费。若你购买了含 API 功能的套餐,可在会员中心 → 开发者 API Key 自助生成密钥,用它调用时可享受对应套餐的保存额度与保留期。
| 方式 | 示例 |
|---|---|
| URL 参数 | ?key=YOUR_API_KEY |
| 请求头 | X-API-Key: YOUR_API_KEY |
curl "https://www.mail0.vip/mail/gen?key=YOUR_API_KEY"
随机生成一个临时邮箱地址。地址生成后即可收信,无需预先激活。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
domain | string | 否 | 指定域名,不传则使用站点默认域名 |
ttl | int | 否 | 收信有效期(分钟),可选 10 / 30 / 60 / 1440。不传默认 10。具体能选哪些由套餐「收信有效期权限」决定,超出权限返回 code=-101 |
curl "https://www.mail0.vip/mail/gen?domain=ideciphera.com&ttl=60"
{
"code": 1,
"address": "k3j8fh2ma@ideciphera.com"
}
启用一个自定义前缀的地址(前缀@域名),校验域名是否开放收信。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
address | string | 是 | 完整邮箱地址,如 mybox@mail0.vip |
ttl | int | 否 | 收信有效期(分钟),可选 10 / 30 / 60 / 1440,规则同 /mail/gen |
curl -X POST "https://www.mail0.vip/mail/activate" \
-d "address=mybox@ideciphera.com&ttl=60"
{
"code": 1,
"address": "mybox@ideciphera.com"
}
拉取指定地址的收件箱(最近 50 封,按接收时间倒序)。建议 1~3 秒轮询一次。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
address | string | 是 | 要查询的邮箱地址 |
curl "https://www.mail0.vip/mail/inbox?address=mybox@ideciphera.com"
{
"code": 1,
"exists": 1,
"address": "mybox@ideciphera.com",
"list": [
{
"id": 1024,
"from_addr": "noreply@example.com",
"from_name": "Example",
"subject": "Your verification code is 826413",
"size": 2048,
"is_read": 0,
"attachments": 0,
"received_at": "2026-10-14 18:20:31"
}
]
}
查看邮件详情(发件人、主题、正文、附件列表)。查看后邮件标记为已读。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
address | string | 是 | 邮箱地址(用于校验归属) |
id | int | 是 | 邮件 ID(来自收件箱列表的 id) |
curl "https://www.mail0.vip/mail/view?address=mybox@ideciphera.com&id=1024"
{
"code": 1,
"data": {
"id": 1024,
"from_addr": "noreply@example.com",
"from_name": "Example",
"subject": "Your verification code is 826413",
"body_text": "Dear user, your verification code is 826413, valid for 5 minutes.",
"received_at_fmt": "2026-10-14 18:20:31",
"attachments": [
{ "id": 88, "filename": "invoice.pdf", "size": 102400 }
]
}
}
下载邮件附件(直接返回文件流,非 JSON)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | int | 是 | 附件 ID(来自邮件详情的 attachments[].id) |
curl -O "https://www.mail0.vip/mail/attach?id=88"
把一个地址保存到你的账号下长期保留(需登录或携带 API Key),数量受套餐「可保存邮箱」限额约束。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
address | string | 是 | 要保存的邮箱地址 |
key | string | 否 | API Key(已登录的网页端不需要) |
curl -X POST "https://www.mail0.vip/mail/save" \
-d "address=mybox@ideciphera.com&key=YOUR_API_KEY"
列出你账号下已保存的邮箱(需登录或携带 API Key)。
curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"
下面这段脚本可直接在浏览器控制台或 Node 环境里跑:生成地址、轮询收件箱、收到第一封邮件就打印验证码。
// 1. 生成一个临时地址 const BASE = 'https://www.mail0.vip'; const gen = await (await fetch(BASE + '/mail/gen')).json(); const address = gen.address; console.log('我的临时邮箱:', address); // 2. 轮询收件箱(每 2 秒一次,收到第一封即停) const seen = new Set(); while (true) { const d = await (await fetch(BASE + '/mail/inbox?address=' + encodeURIComponent(address))).json(); for (const m of d.list || []) { if (seen.has(m.id)) continue; seen.add(m.id); const code = (m.subject || '').match(/\d{4,8}/); console.log('新邮件:', m.subject, code ? '验证码 ' + code[0] : ''); } await new Promise(r => setTimeout(r, 2000)); }
| 项目 | 说明 |
|---|---|
| 收信额度 | 每个地址有每日收信上限(免费 30 封/天,会员更高),超出后新邮件会被拒绝 |
| 邮件保留 | 邮件按套餐保留期自动清理(免费 7 天,会员 30/90 天),请及时收取 |
| 轮询频率 | 建议 1~3 秒一次,请勿高频并发轮询同一地址 |
| 收信有效期 | 地址有效期由 ttl 参数决定,可选的时长按套餐「收信有效期权限」控制(免费套餐默认仅 10 分钟);过期后该地址不再收信,「保存此邮箱」可长期保留 |
| 地址隐私 | 临时邮箱按地址公开可读,任何人知道地址即可查看其中的邮件 |
| 错误格式 | 失败时返回 {"code":0,"msg":"原因"},成功为 code=1;code=-100 表示未登录或 API Key 无效,code=-101 表示所选有效期超出套餐权限 |
更多使用技巧与常见问题,一篇文章讲清楚
打开首页点击「更新邮箱」即可一键生成随机临时地址,也可自定义前缀与域名。
阅读全文 →临时邮箱(Temporary / Disposable Email)是一种免注册、即用即弃的电子邮件地址,用于接收验证码和临时邮件。
阅读全文 →点击「保存此邮箱」将地址转为长期地址,登录会员中心可统一管理。
阅读全文 →点击地址条上的「复制」按钮,把地址粘贴到目标网站的邮箱输入框即可完成注册。
阅读全文 →临时邮箱匿名即用即弃、不绑定身份;正规邮箱长期持有、需注册且可找回,二者定位不同。
阅读全文 →收不到邮件多为地址已过期、发件延迟或网站屏蔽临时邮箱域名,可在有效期内刷新或换域名重试。
阅读全文 →