用途:MailSac API 面向一次性邮箱与邮件测试场景,可通过 API 读取、管理测试邮箱中的邮件,适合注册验证码提取、邮件流程调试等用途。
主要能力:读取邮件(列表、纯文本正文、HTML 正文、原始 SMTP 报文、JSON 头部);删除单封邮件或清空整个收件箱;预留和释放私有地址;配置 Webhook 实时转发;验证邮箱格式及是否为一次性邮箱;发送外发邮件;下载附件;星标邮件防止自动删除。
使用方式:所有请求需设置 MAILSAC_TOKEN,基础 URL 为 https://mailsac.com,并通过 --header "Mailsac-Key: $MAILSAC_TOKEN" 认证。例如列出收件箱邮件:curl -s "https://mailsac.com/api/addresses/test@mailsac.com/messages" --header "Mailsac-Key: $MAILSAC_TOKEN" | jq . 。常见端点包括 /api/text/{email}/{messageId}、/api/body/{email}/{messageId}、/api/raw/{email}/{messageId}、/api/headers/{email}/{messageId}。发送邮件 POST 到 /api/outgoing-messages,需要外发邮件额度;私有域名内发送除外。故障排查可运行 zero doctor check-connector --env-name MAILSAC_TOKEN。
适用场景:自动化测试中等待并提取验证码、清理测试收件箱、检查邮箱是否为一次性服务等。
限制:公共地址邮件保留 4 天,收件箱最多 6 封,单封最大 2.5 MB,操作额度按每月 1 日 UTC 重置。免费账户可能被限流,付费计划上限更高。公共地址任何人可访问,敏感测试数据应使用私有地址。清空收件箱不会删除星标邮件,需先取消星标。公共地址附件必须通过 API 下载,网页不可查看。发送邮件需要购买额度(自定义域名内发送除外)。