核心用法
API Gateway 是由 Maton 提供的第三方 API 代理服务，支持通过单一接口访问 100+ 主流 SaaS 服务（Google Workspace、Microsoft 365、Slack、GitHub、Notion、HubSpot、Stripe 等）。核心机制为 Passthrough Proxy：用户通过 https://gateway.maton.ai/{app}/{native-api-path} 调用目标服务的原生 API，Maton 自动注入 OAuth Token 完成认证。
工作流程：
1. 获取 MATON_API_KEY 并设置环境变量
2. 通过 ctrl.maton.ai 创建服务连接，完成 OAuth 授权
3. 使用原生 API 路径调用，Maton 网关自动代理请求
关键特性：
- 支持完整 REST API 操作（GET/POST/PUT/PATCH/DELETE）
- 自定义 Headers（除 Host/Authorization）透传至目标 API
- Query 参数完全透传
- 多连接管理（通过
Maton-ConnectionHeader 指定）
显著优点
1. 极简集成：无需维护各平台的 OAuth 流程、Token 刷新、密钥轮换
2. 原生 API 兼容：直接调用官方文档中的 API 端点，无学习成本
3. 覆盖全面：130+ 服务，涵盖 CRM、项目管理、通讯、AI 服务、支付等全场景
4. 安全隔离：Maton API Key 本身不授予任何第三方权限，每项服务需独立 OAuth 授权
5. 企业级支持：包含 Google Workspace Admin、Salesforce、HubSpot 等复杂企业系统
潜在缺点与局限性
1. 数据隐私权衡：所有请求流经 Maton 服务器，敏感数据（邮件内容、聊天记录）存在第三方处理风险
2. 网络依赖：完全依赖 Maton 服务可用性，无法离线或私有部署
3. 限流约束：10 requests/second/account，高频场景需自行节流
4. 调试复杂度：错误需区分 Maton 网关层（401/429）与目标 API 层（4xx/5xx）
5. 上传场景限制：部分预签名 URL（如 LinkedIn 媒体上传）需绕过网关直接上传，增加了集成复杂度
适合人群
- AI Agent/LLM 开发者：需快速集成多源数据，无需维护 OAuth 基础设施
- 自动化工程师：构建跨平台工作流（如 Slack→Notion→Salesforce 数据同步）
- 初创团队：缺乏专职 DevOps，希望降低第三方 API 集成成本
- 数据分析师：需统一访问 Google Sheets、Airtable、BigQuery 等数据源
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 密钥泄露 | 中 | `MATON_API_KEY` 泄露可导致未授权访问所有已授权服务 |
| OAuth 过度授权 | 中 | 用户可能授予超出实际需求的权限范围 |
| 服务终止 | 低 | 依赖 Maton 商业可持续性，存在供应商锁定风险 |
| 数据合规 | 低 | 跨境数据传输需确认符合 GDPR/CCPA 等法规 |
缓解建议：定期轮换 API Key、启用最小权限 OAuth、监控异常流量、审查活跃连接列表。