首页 价格方案 API 文档 常见问题 职业生成器 身份生成器 地址生成器

API 文档

用 HTTP 接口生成临时邮箱、收取邮件,把收信能力集成到你自己的脚本、测试流水线或机器人里。

接口基地址https://www.mail0.vip 全部接口返回 JSON(附件下载除外)。游客可直接匿名调用;购买含 API 套餐的用户还可用 API Key 以账号身份调用(享对应套餐配额),见下方「API Key 认证」。
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"
错误:Key 无效或已停用时接口会返回错误码,请留意 msg 字段。密钥请妥善保管,切勿硬编码在前端代码或提交到公开仓库。
GET /mail/gen

随机生成一个临时邮箱地址。地址生成后即可收信,无需预先激活。

请求参数

参数类型必填说明
domainstring否指定域名,不传则使用站点默认域名
ttlint否收信有效期(分钟),可选 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"
}
提示:ttl 可传 10 / 30 / 60 / 1440(分钟),不传默认 10;具体能选哪些由套餐的「收信有效期权限」决定,超出权限会返回 code=-101。
POST /mail/activate

启用一个自定义前缀的地址(前缀@域名),校验域名是否开放收信。

请求参数

参数类型必填说明
addressstring是完整邮箱地址,如 mybox@mail0.vip
ttlint否收信有效期(分钟),可选 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"
}
错误:code=0 时 msg 为「邮箱格式不正确」或「该域名未开放收信」;code=-101 表示所选有效期超出套餐权限。
GET /mail/inbox

拉取指定地址的收件箱(最近 50 封,按接收时间倒序)。建议 1~3 秒轮询一次。

请求参数

参数类型必填说明
addressstring是要查询的邮箱地址

请求示例

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"
    }
  ]
}
提示:exists=0 表示该地址还未收到过任何邮件(地址本身仍可用)。JS 里用 list[].id 去重即可实现「只处理新邮件」。
GET /mail/view

查看邮件详情(发件人、主题、正文、附件列表)。查看后邮件标记为已读。

请求参数

参数类型必填说明
addressstring是邮箱地址(用于校验归属)
idint是邮件 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 }
    ]
  }
}
GET /mail/attach

下载邮件附件(直接返回文件流,非 JSON)。

请求参数

参数类型必填说明
idint是附件 ID(来自邮件详情的 attachments[].id)

请求示例

curl -O "https://www.mail0.vip/mail/attach?id=88"
POST /mail/save

把一个地址保存到你的账号下长期保留(需登录或携带 API Key),数量受套餐「可保存邮箱」限额约束。

请求参数

参数类型必填说明
addressstring是要保存的邮箱地址
keystring否API Key(已登录的网页端不需要)

请求示例

curl -X POST "https://www.mail0.vip/mail/save" \
  -d "address=mybox@ideciphera.com&key=YOUR_API_KEY"
GET /mail/my

列出你账号下已保存的邮箱(需登录或携带 API Key)。

请求示例

curl "https://www.mail0.vip/mail/my?key=YOUR_API_KEY"
JS 完整示例:生成地址 → 等待验证码邮件

下面这段脚本可直接在浏览器控制台或 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)是一种免注册、即用即弃的电子邮件地址,用于接收验证码和临时邮件。

阅读全文 →

如何保存邮箱以便长期接收邮件?

点击「保存此邮箱」将地址转为长期地址,登录会员中心可统一管理。

阅读全文 →

如何复制邮箱地址并在其他网站注册?

点击地址条上的「复制」按钮,把地址粘贴到目标网站的邮箱输入框即可完成注册。

阅读全文 →

临时邮箱和正规邮箱(Gmail / QQ 等)有什么区别?

临时邮箱匿名即用即弃、不绑定身份;正规邮箱长期持有、需注册且可找回,二者定位不同。

阅读全文 →

为什么我收不到验证码或邮件?

收不到邮件多为地址已过期、发件延迟或网站屏蔽临时邮箱域名,可在有效期内刷新或换域名重试。

阅读全文 →

友情链接

服务项目 行业链接
© mail0.vip 免费临时邮箱