核心功能
该技能提供完整的 Mailgun API 代理服务，支持：
- 邮件发送：标准邮件、MIME 格式邮件、模板邮件
- 域名管理：创建、删除、查看域名及跟踪设置
- 路由配置：基于收件人、邮件头的自动路由规则
- 事件追踪：发送状态、打开、点击等事件查询
- Webhook 管理：实时接收投递状态回调
- 模板系统：Handlebars 模板创建与管理
- 邮件列表：订阅列表管理与成员维护
- 退信管理：Bounces、Unsubscribes、Complaints 处理
- 统计分析：按事件类型统计邮件投递数据
显著优点
1. 托管 OAuth 简化认证：无需直接管理 Mailgun API Key，通过 Maton 统一 OAuth 流程
2. 完整功能覆盖：涵盖 Mailgun v3 API 绝大多数功能点
3. 多连接支持：可同时管理多个 Mailgun 账户，通过 Maton-Connection 头切换
4. 区域兼容：默认 US 区域，支持标准 Mailgun 功能
5. 安全审批机制：所有写操作需用户显式确认
潜在局限
1. 区域限制：默认仅代理 US 区域（api.mailgun.net），EU 区域需额外配置
2. 表单编码要求：POST/PUT 需使用 application/x-www-form-urlencoded 而非 JSON，增加开发复杂度
3. 沙箱域名限制：免费账户的沙箱域名只能发送给授权收件人
4. 依赖 Maton 服务：API 可用性绑定 Maton 平台，非直连 Mailgun
5. 事件存储期短：仅保留 3 天，需及时导出或配置 webhook 持久化
适合人群
- 需要程序化发送交易邮件的开发者/团队
- 已使用 Mailgun 且希望简化认证流程的企业
- 需统一管理多个邮件服务账户的技术运营团队
- 构建邮件自动化工作流的低代码/无代码平台用户
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | `MATON_API_KEY` 泄露导致账户被滥用 | 使用环境变量，避免硬编码；定期轮换密钥 |
| 邮件滥用 | 被利用发送垃圾邮件导致域名声誉受损 | 启用 suppressions 管理；监控发送量和退信率 |
| 数据泄露 | 邮件内容或收件人列表通过日志暴露 | 避免在日志中记录敏感内容；使用密送(BCC) |
| 速率限制 | 高频调用触发限流影响业务 | 实现指数退避重试；合理规划发送批次 |
| OAuth 会话过期 | 长期运行的自动化任务因授权失效中断 | 监控连接状态；设置会话续期提醒 |