curl https://mailera.app/api/public/v1/mailboxes \ -H "X-API-Key: mh_live_..."快速入门
- 1
创建 API key
免费注册，前往设置 → API key，并为其选择权限。
- 2
导入邮箱
将邮箱列表发送到导入端点，逐行跟踪结果。
- 3
读取与发送
按文件夹获取邮件、读取 OTP 验证码、发送或回复邮件。
API key 权限
每个 API key 只能执行获准的操作。
| 权限范围 | 允许的操作 |
|---|---|
read | 读取邮箱、邮件、OTP 验证码及邮件投递位置（收件箱或垃圾邮件） |
move | 将邮件移出垃圾邮件文件夹或在文件夹之间移动 |
import | 添加邮箱 |
sync | 请求立即同步 |
send | 发送、回复和转发邮件 |
manage | 暂停、恢复和删除邮箱 |
webhooks | 管理 webhook |
webhook
邮件一到，即刻接收事件。
Mailera 向您的 URL 发送 POST 请求，在 X‑MailHub‑Signature 请求头中附带 HMAC-SHA256 签名，并在端点失败时自动重试。
message.received新邮件到达收件箱message.junk新邮件进入垃圾邮件文件夹mailbox.disconnected邮箱连接断开（token 被撤销、密码已更改等）
限制与详情
- 请求速率限制
- 每个 API key 每分钟 300 次请求
- 身份验证
- X-API-Key 请求头
- 每个免费工作区的邮箱数量
- 最多 1,000 个邮箱
- 分页
- cursor 和 next_cursor
- 机器可读描述
- OpenAPI 3.1 · llms.txt