核心用法
Mailtarget 提供完整的邮件基础设施 API,覆盖发送、模板管理、域名配置三大核心场景。
邮件发送:通过 REST API 向 transmission.mailtarget.co/v1 发送 POST 请求,支持 HTML/纯文本双格式、CC/BCC、自定义回复地址、附件(base64 编码)及自定义头。模板发送使用 templateId + substitutionData 实现动态内容注入。
追踪控制:optionsAttributes 支持开关级点击/打开追踪,transactional: true 可绕过退订偏好,适用于密码重置、订单确认等事务性邮件。
模板管理:CRUD 操作支持分页列表与关键词搜索,模板以 ID 为 slug,包含显示名称与 HTML 内容。
发送域名:完整的域名生命周期管理——创建、SPF/DKIM/CNAME 记录获取、TXT 验证、SPF 建议查询。与 cloudflare-dns 技能联动可实现零手动 DNS 的自动化域名开通。
显著优点
- 功能完整:事务/营销邮件、模板变量、附件、追踪、子账户、API 密钥管理一站式覆盖
- 自动化友好:标准化的 REST 接口与 JSON 格式,易于脚本集成
- 生态联动:与 Cloudflare DNS 技能深度集成,域名验证全流程自动化
- 追踪灵活:单封邮件级追踪开关,事务邮件可强制投递
潜在局限
- 地域认知度:Mailtarget(mailtarget.co)相较 AWS SES、SendGrid 等主流厂商市场份额与社区资料有限
- 附件限制:需自行处理 base64 编码,大附件增加请求体积
- 错误处理细节:文档未详述退信、垃圾邮件判定等边缘情况的返回码策略
适合人群
- 需要快速集成邮件功能的开发者与自动化工作流构建者
- 已使用或计划使用 Cloudflare DNS 的技术团队
- 东南亚市场(印尼为主)业务主体,契合 Mailtarget 服务区域
常规风险
- API 密钥泄露:
MAILTARGET_API_KEY需妥善保管,避免硬编码提交至版本控制 - 域名信誉:新域名需逐步预热,自动化批量发送可能触发反垃圾机制
- CNAME 代理:自动化配置时需显式设置
proxied: false,避免 Cloudflare 代理导致验证失败