邮箱工作台
收件箱
正在连接
已生成收件地址复制到需要接收邮件的网站即可,无需单独创建邮箱。
最近 7 天
选择一封邮件
在左侧选择来信,
阅读或复制邮件正文。
邮件内容,交给你的程序处理
读取指定邮箱的邮件正文
先查询邮件列表,再按邮件 ID 获取纯文本正文。主题、发件人、收件人和时间也会一起返回。
- 使用任意邮箱前缀,例如
- 查询列表,取得需要读取的邮件
id - 请求邮件详情,从
body读取正文
查询列表 → 读取正文
认证方式
请求头使用 Authorization: Bearer 你的密钥。密钥可以访问全部收件地址,请只放在服务端或你自己的程序里。
| 列表参数 | 用途 |
|---|---|
to | 完整收件邮箱地址;省略则查询全部地址 |
since | 只读取指定时间及之后的邮件;Unix 时间戳,单位秒,可带小数 |
sender | 精确匹配 SMTP 发件地址 |
subject | 主题包含的文字 |
after | 传入游标,按邮件 ID 从旧到新读取 |
limit | 每页数量,默认 50,最多 100 |
持续接收新邮件
GET /api/messages?to=邮箱&after=0&limit=50 按游标从旧到新读取。成功处理完一页后,保存 next_cursor,作为下次的 after。如果 has_more 为真,继续读取下一页;没有新邮件时,建议等待 5 秒再查询。
GET /api/messages/邮件ID 获取正文。列表中的 preview 只是前 140 个字符。
正文为纯文本,内容如何识别和使用由调用程序决定。附件不保存,邮件保留 7 天;超长正文会标记 truncated。