用途:Mailtrap Email Sandbox 把外发邮件捕获到沙箱(测试收件箱),不投递给真实收件人,适合开发、预发布、CI 和演示环境;也用于检查邮件正文、头信息、附件及垃圾邮件报告,并对捕获邮件做自动化断言。
主要能力:支持 SMTP、HTTP API 和官方 SDK 两种发送方式。SMTP 适合已有 SMTP 发信的既有应用,只需改主机与凭据即可把邮件送入沙箱;HTTP API 更适合新建集成或做程序化测试与自动化。
必要用法:REST 发送地址为 https://sandbox.api.mailtrap.io/api/send/{inbox_id},认证头 Authorization: Bearer $MAILTRAP_SANDBOX_API_TOKEN。沙箱使用单独的 token(Testing/Sandbox 作用域),不要复用线上 $MAILTRAP_API_TOKEN;account_id 可通过 GET https://mailtrap.io/api/accounts 获取,token 应存于环境变量或密钥管理。SMTP 设置为:主机 sandbox.smtp.mailtrap.io,端口 2525(默认)、25、465(SSL)、587,用户名与密码按 Mailtrap UI 集成页的沙箱凭据填写;每个测试收件箱都有唯一 inbox id。
适用场景:捕获开发/测试/预发布全部外发邮件;查看并校验头、正文、HTML、附件或垃圾评分;在 CI 中读取沙箱 API 做集成检查;测试 Mailtrap 模板时把 API/SDK/SMTP 指向沙箱。
限制:沙箱邮件永不投递给真实收件人,切勿在生产使用沙箱凭据或端点;不要混用测试 API 与线上发送端点 send.api.mailtrap.io;必须提供正确 inbox id。安装命令、完整 SDK 语言列表和全部 API 字段暂未提供,需查阅 Mailtrap 官方文档与各 SDK 仓库 README。