核心用法
MailerLite skill 通过 Maton 网关提供对 MailerLite API 的托管式 OAuth 接入，用户无需自行处理复杂的 OAuth 授权流程。核心能力覆盖完整的邮件营销生命周期：
订阅者管理：创建/更新订阅者（邮箱作为唯一标识）、按状态筛选（active/unsubscribed/bounced 等）、查询活动日志、批量分组管理，以及 GDPR 合规的「遗忘」功能。
分组与细分：创建动态分组（Groups）和行为细分（Segments），支持按打开率、点击率等指标排序，实现精准受众定位。
邮件活动：创建常规/AB测试/RSS 等多类型活动，支持即时发送或定时调度，提供完整的投递状态追踪和订阅者互动分析。
自动化工作流：构建触发式邮件序列（如欢迎系列），监控自动化执行状态，支持按完成度、失败原因等维度排查。
表单与字段：管理弹窗、嵌入式、促销三类表单，自定义文本/数字/日期等字段类型，完整追踪表单转化率。
Webhook 集成：订阅 subscriber.created、subscriber.updated 等事件，实现实时数据同步。
显著优点
1. 零 OAuth 运维：Maton 托管令牌刷新和失效处理，大幅降低集成门槛
2. 原生 API 透传：网关仅做路径转发和鉴权注入，保留 MailerLite 完整功能语义
3. 多租户支持：通过 Maton-Connection 头部可在同一密钥下管理多个 MailerLite 账户
4. 完善的调试指引：文档包含详细的错误码映射、环境变量检查命令、curl 注意事项
5. 分页机制透明：自动处理 cursor-based 和 page-based 两种分页风格
潜在缺点与局限性
- 速率限制较严格：120 请求/分钟，大规模数据同步需配合退避策略
- 网关依赖风险：服务可用性绑定 Maton 基础设施，非直连 MailerLite
- 连接管理 overhead：首次使用需完成 OAuth 授权流程，无法纯 API key 冷启动
- 功能边界模糊：部分高级功能（如拖拽编辑器模板操作）需验证是否完整透传
- 调试信息层级：复杂场景下（如 422 验证错误）可能需直连原 API 对比响应
适合人群
- 初创/SaaS 团队：需要快速搭建邮件营销基础设施，无力维护 OAuth 服务
- 营销自动化开发者：构建用户生命周期管理、线索培育等自动化流程
- 数据同步场景：将 MailerLite 与 CRM、电商平台进行双向数据打通
- 合规敏感业务：需要内置 GDPR 遗忘机制和多租户数据隔离
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 令牌泄露 | MATON_API_KEY 泄露可能导致全部连接被滥用 | 使用密钥管理服务，避免硬编码 |
| OAuth 授权漂移 | 用户撤销 MailerLite 授权后连接失效 | 实现连接状态健康检查，主动告警 |
| 速率限制触发 | 批量操作易触达 120 req/min 上限 | 实施指数退避重试，控制并发 |
| 数据残留 | 删除订阅者后部分聚合统计可能仍保留 | 结合 forget API 并审计日志确认 |
| 网关单点故障 | Maton 服务中断影响全部 API 调用 | 核心业务考虑 MailerLite 直连降级方案 |