用途:在集成、配置或排查 Mailtrap 真实邮件发送时使用,涵盖 Email API(REST)、SMTP、事务流(Transactional)、批量流(Bulk)以及 batch 请求。不适用于仅用 Sandbox 捕获邮件、Campaigns UI 设置、Webhooks 深入或完整 API 参考。
主要能力与选择:Transactional 为应用生成的非促销邮件;Bulk 为面向自管联系人的促销/营销量;Batch 不是第三种流,而是在匹配内容流的端点上一次提交多封消息(每请求最多 500 封)。Campaigns 为独立产品路径,需先完成 UI 设置。集成优先级:平台插件/集成、官方 SDK、HTTP Email API、最后 SMTP。
端点为:Transactional 发送 POST https://send.api.mailtrap.io/api/send,batch 对应 /api/batch;Bulk 使用 https://bulk.api.mailtrap.io/api/send 与 /api/batch。授权头为 Authorization: Bearer $MAILTRAP_API_TOKEN。SMTP 主机为 live.smtp.mailtrap.io(Transactional)与 bulk.smtp.mailtrap.io(Bulk),端口 587(也可 25、2525、465 SSL),用户名为 api,密码为 API token。令牌可放环境变量或密钥管理器,同令牌按 scope 覆盖对应流。速率限制为每令牌每 10 秒 150 请求,429 需退避。
JSON 正文常用 from、to、subject、text/html,可选 category、custom_variables;模板使用 template_uuid 与 template_variables。示例:curl -X POST https://send.api.mailtrap.io/api/send -H "Authorization: Bearer $MAILTRAP_API_TOKEN" -H "Content-Type: application/json" -d '{...}'。SDK 覆盖 Node.js、Python、PHP、Ruby、Java、.NET 与 CLI。Mailtrap 自动管理硬退信、举报垃圾邮件或退订的抑制地址。
限制:使用当前 API 文档获取完整 schema 与产品限制;生成 SDK 代码前应先读对应 SDK README,不要凭记忆。常见错误包括混淆 batch 与 bulk、促销邮件误用事务主机、live 发送误用 Sandbox SMTP 主机、用户名误填邮箱、域名未验证即发送。相关技能:mailtrap-testing-with-sandbox、mailtrap-setting-up-sending-domain。