核心用法
API Gateway 是 Maton 提供的托管式 OAuth 代理服务，允许用户通过单一 API 密钥（MATON_API_KEY）安全调用 100+ 第三方服务 API，包括 Google Workspace、Microsoft 365、Slack、GitHub、Notion、Airtable、HubSpot、Salesforce 等主流 SaaS 平台。
典型工作流程：
1. 环境配置：设置 MATON_API_KEY 环境变量
2. 连接授权：通过 Maton 连接管理接口创建 OAuth 连接，用户在浏览器中完成授权
3. API 调用：使用 https://api.maton.ai/{app-name}/{native-api-path} 格式发起请求，Maton 服务端代理转发
4. 多账户管理：通过 Maton-Connection 头指定特定连接，支持同一服务的多账户场景
关键特性：
- 零令牌暴露：OAuth 令牌由 Maton 服务端托管，不返回给代理
- 原生 API 兼容：直接透传目标服务的官方 API 路径和参数
- 连接生命周期管理：支持创建、查询、删除连接，实时监控连接状态
- 细粒度权限控制：每个连接独立授权，严格限定 OAuth 作用域
显著优点
1. 安全架构设计：采用反向代理模式，敏感凭证始终保存在 Maton 服务端；支持 TLS 1.2+ 加密传输；明确的安全指引要求敏感操作必须用户确认
2. 极低的集成成本：无需自行实现 OAuth 流程、令牌刷新、错误重试等复杂逻辑；统一的身份验证模式大幅降低多服务接入的技术门槛
3. 广泛的服务覆盖：支持 180+ 外部 API，涵盖 CRM、协作办公、云存储、营销自动化、财务系统等核心企业应用场景，且持续扩展
4. 合规与审计友好：来源可信度 T2 级（可信组织 Maton）；通过 GDPR 数据最小化、用户明示同意、敏感数据加密、访问权限控制等 6 项合规检查；纯文档型 Skill 无可执行代码，风险可控
潜在缺点与局限性
1. 供应商锁定风险：核心功能依赖 Maton 服务的可用性，若 Maton 服务中断或策略变更，可能影响所有已集成的第三方服务访问
2. 速率限制约束：Maton 平台限速 10 请求/秒/账户，且各上游 API 自身的速率限制同样生效，高并发场景需额外设计缓存或队列机制
3. 网络延迟增加：请求需经过 Maton 代理层转发，相比直连目标 API 存在一定延迟，对 latency 敏感的场景需评估影响
4. 功能边界限制：作为代理层，某些需要特殊处理的场景（如 LinkedIn 预签名上传 URL）需绕过网关直接上传；GraphQL 接口（Linear、Monday.com）需额外注意查询构造
适合人群
- 多平台数据整合需求者：需要统一查询或操作分散在多个 SaaS 工具中的数据
- 快速原型开发团队：希望快速验证跨服务自动化工作流，无需投入大量时间在 OAuth 集成上
- 企业自动化场景：CRM 数据同步、营销自动化、财务报告汇总、项目管理数据抽取等
- 安全意识较强的用户：偏好凭证托管而非本地存储，重视细粒度权限控制
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| API 密钥泄露 | `MATON_API_KEY` 若泄露，攻击者可访问用户已授权的所有服务连接 | 定期轮换密钥；不同环境使用独立密钥；禁止日志或共享文件中暴露 |
| 过度授权 | 用户可能授权超出实际需要的 OAuth 作用域 | 遵循最小权限原则；及时撤销未使用的连接；定期审计已授权服务 |
| 误操作风险 | 自动化脚本可能意外修改或删除生产数据 | 所有 POST/PUT/PATCH/DELETE 操作强制要求用户确认；高影响操作额外提示 |
| 上游服务变更 | 第三方 API 版本更新或弃用可能导致代理失效 | 关注上游服务公告；使用官方 API 文档验证路径参数 |
| 连接令牌过期 | OAuth 令牌过期导致 API 调用失败 | 监控连接状态；建立令牌刷新或重新授权机制 |
安全评级：S+（优秀） — 纯文档型 Skill 无自动执行风险，安全设计完善，来源可信，适合生产环境使用。