功能概述
systeme 是一款专为 Systeme.io 设计的官方 API 集成技能，通过 Maton 托管代理实现零配置 OAuth 认证，让开发者无需处理复杂的令牌刷新与权限管理即可调用 Systeme.io 完整接口。
核心能力
该技能覆盖 Systeme.io 平台的五大业务域：联系人管理（CRUD 操作、标签关联、自定义字段）、课程与学员管理（课程查询、学员注册/取消、访问权限控制）、社群运营（社群列表、成员管理）、订阅计费（订阅查询、取消操作）以及标签系统（创建、分配、删除）。所有操作均通过 api.maton.ai 代理层转发，自动完成身份凭证注入。
显著优势
1. 托管式 OAuth：开发者无需自建 OAuth 流程，通过 Maton 控制台一键授权，连接状态持久化托管
2. 多账户支持：通过 Maton-Connection 头可指定多个 Systeme.io 账户，适合代运营或多品牌场景
3. 开发友好：提供完整的 Python、JavaScript、Bash 代码示例，支持 cursor-based 分页与标准 REST 语义
4. 安全兜底：所有写入操作强制要求用户二次确认，降低误操作风险
局限与注意事项
- 依赖 Maton 服务可用性：若 Maton 代理层故障，将完全无法调用 Systeme.io API
- 功能边界：不支持 Systeme.io 的漏斗构建、邮件发送、支付网关配置等高级功能
- 速率限制：受 Systeme.io 原生限流策略约束，高频场景需自行实现退避重试
- 订阅端点限制：若目标账户未开通支付功能，
/payment/subscriptions将返回 404
适用人群
- 需要自动化学员注册、社群成员管理的在线教育机构
- 使用 Systeme.io 作为 CRM 的中小电商团队
- 为多客户代管 Systeme.io 账户的技术服务商
常规风险
- 密钥泄露：
MATON_API_KEY一旦泄露，攻击者可操作所有已授权连接，需严格保管 - 误删数据：DELETE 操作不可逆，建议在生产环境启用操作审计
- 权限漂移：Systeme.io 账户权限变更后，Maton 连接不会自动感知，需定期核查