核心用法
Maton API Gateway 是一个托管型第三方 API 统一接入层，通过单一 MATON_API_KEY 即可调用 100+ 主流 SaaS 服务的原生 API。其核心工作模式为：
1. 连接管理：用户在 Maton 平台创建服务连接（Slack、Notion、Salesforce 等），完成 OAuth 授权
2. 统一调用：通过 https://api.maton.ai/{app}/{native-api-path} 格式直接调用各服务原生 API
3. 多账户切换：使用 Maton-Connection 头部在多个同服务账户间精确指定
典型调用示例：
- Slack 频道列表：
GET /slack/api/conversations.list - Gmail 邮件查询：
GET /google-mail/gmail/v1/users/me/messages - Notion 数据库查询：
POST /notion/v1/data_sources/{id}/query
显著优点
- 一钥多能：单环境变量替代数十个服务各自的密钥管理
- 原生 API 透传：非封装式 SDK，直接透传官方 API，文档即代码
- OAuth 托管：免除自建 OAuth 应用、刷新 Token、处理授权回调的复杂运维
- 180+ 服务覆盖：从基础办公（Google Workspace、Microsoft 365）到专业领域（Salesforce、Stripe、HubSpot、Zoho 全家桶）全覆盖
- 安全设计：密钥强制环境变量存储，代码示例中无硬编码；修改操作强制用户显式确认
潜在局限
- 网络依赖：所有调用必须经过 Maton 网关，无法离线或私有部署
- 速率限制：10 req/s 的网关级限制，高频场景需本地缓存策略
- 供应商锁定：服务可用性依赖 Maton 平台持续运营
- OAuth 授权摩擦：首次使用每项服务需完成浏览器跳转授权流程
- 调试复杂度：网关层增加问题定位环节，原生 API 错误需透传解析
适合人群
- 多 SaaS 整合开发者：需同时对接 5+ 以上服务的自动化、集成项目
- 快速原型团队：避免逐个服务申请 API 密钥、搭建 OAuth 流程
- 无运维资源的小团队：不愿自建 Token 刷新、密钥轮换基础设施
- AI Agent 构建者：大模型需要标准化工具调用接口访问外部数据
常规风险
| 风险项 | 说明 | 缓解措施 |
|--------|------|----------|
| 密钥泄露 | `MATON_API_KEY` 泄露导致所有连接服务暴露 | 环境变量隔离、日志脱敏、定期轮换 |
| 越权操作 | 修改类 API 误调用导致数据丢失 | 强制用户确认、优先只读验证、明确指定 Connection |
| Token 过期 | OAuth 刷新失败导致 500 错误 | 监控连接状态、及时重新授权 |
| 多账户混淆 | 未指定 Connection 导致操作错误账户 | 多账户场景必传 `Maton-Connection` 头部 |
| 数据隐私 | 业务数据流经 Maton 网关 | 审查 Maton 隐私政策、敏感数据评估 |
认证评估：CLS-Certify v2.1.0 扫描获 A 级（85 分），T1 可信来源，无恶意代码、无硬编码密钥、无动态代码加载风险。