用途:在应用中集成、配置或排查 Mailtrap 的实时邮件发送,覆盖 Email API(REST)与 SMTP 两种方式,适合构建或调试外发邮件集成(含 AI 辅助编码场景)。
主要能力:区分两条流——Transactional(应用生成的非营销邮件)与 Bulk(营销/推广批量邮件);Batch 不是第三条流,而是在匹配的流上通过 /api/batch 一次提交多条消息(每请求最多 500 条)。Campaigns 是面向 Mailtrap 联系人的独立推广产品路径,需先在 UI 中设置。
集成优先级:优先使用平台插件或集成(无代码/最少配置);其次使用官方 SDK(Node.js、Python、PHP、Ruby、Java、.NET、CLI);无 SDK 或不适用时用 HTTP Email API(POST /api/send 或 /api/batch,JSON);仅在确有需要(遗留栈、仅支持 SMTP 的平台等)时用 SMTP。生成 SDK 代码前应阅读对应 SDK 仓库 README,不要凭记忆。
端点与鉴权:Transactional 用 POST https://send.api.mailtrap.io/api/send 与 /api/batch;Bulk 用 POST https://bulk.api.mailtrap.io/api/send 与 /api/batch。请求头为 Authorization: Bearer $MAILTRAP_API_TOKEN(也支持 Api-Token)。同一 token 在两个主机均可用,前提是其作用域覆盖对应流。SMTP:Transactional 主机 live.smtp.mailtrap.io,Bulk 主机 bulk.smtp.mailtrap.io,端口 587(也支持 25、2525、465 带 SSL),用户名 api,密码为 API token。
请求体:非模板发送常用字段 from、to、subject、text 和/或 html,可选 category、custom_variables;模板发送用 template_uuid 与 template_variables 替代原始正文。
限流:发送 API 每 token 每 10 秒 150 次请求,遇 429 应退避重试。
限制与注意:本技能不覆盖仅沙箱捕获邮件、webhooks、Campaigns UI 分步设置、投递率深入分析或完整 API 参考;发送前需完成 Sending Domains 验证与合规。Mailtrap 会自动管理硬退信、举报垃圾邮件或退订地址的抑制,不再向其发送。常见错误包括混淆 batch 与 bulk、在 transactional 主机发推广邮件、用沙箱 SMTP 主机做实时发送、把 SMTP 用户名写成邮箱、未验证域名即发送。