api-gateway

核心用法

API Gateway 是 Maton 提供的透明代理服务，允许开发者通过单一入口调用 100 余种第三方服务的原生 API。用户只需获取 Maton API Key 并完成目标服务的 OAuth 授权，即可通过 https://gateway.maton.ai/{app}/{native-api-path}} 的 URL 格式直接转发请求。网关会自动注入对应的 OAuth Token，无需开发者自行管理多平台的认证凭证。连接管理通过独立的 ctrl.maton.ai 端点进行，支持创建、查询、删除连接及指定特定连接 ID 进行调用。

显著优点

极致的集成效率：覆盖 Slack、HubSpot、Salesforce、Stripe、Google 全系列、Notion、Airtable 等 100+ 主流服务，单点接入即可打通企业常用工具链，避免重复开发认证模块。

零代码托管负担：OAuth Token 的全生命周期管理（获取、刷新、存储）由 Maton 托管，开发者无需维护 Token 刷新逻辑或安全存储方案。

原生 API 兼容性：直接透传第三方服务的原生 API 路径和参数，可使用官方文档无差别调用，学习成本极低。

多语言友好：提供 Python、JavaScript 等语言的完整示例，支持所有 HTTP 方法及自定义 Header 转发。

潜在缺点与局限性

供应商锁定风险：所有 API 流量必须经过 Maton 服务器中转，形成单点依赖；若 Maton 服务中断或调整定价，迁移成本较高。

数据隐私顾虑：请求体、响应数据及 OAuth Token 均流经并存储于第三方服务器，对高度敏感数据（如金融交易详情、医疗记录）存在合规隐患。

速率限制约束：硬性限制 10 请求/秒/账户，高并发场景需自行实现队列或降级方案，无法突破第三方 API 本身的限流。

调试复杂度：错误需区分 Maton 网关层（401/429）与目标 API 层（4xx/5xx），且 OAuth 失效时表现为 500 错误，排查路径较长。

适合的目标群体

• 快速原型开发者：需在短期内验证多平台集成可行性的创业团队或独立开发者
• 中小型企业 IT 部门：缺乏专职运维人员，希望降低 OAuth 集成复杂度的组织
• 自动化工作流构建者：使用 n8n、Make 等工具的用户，可通过 HTTP 节点直接调用
• 多租户 SaaS 产品：需为客户快速接入第三方服务，但不愿承担 Token 管理责任的产品团队

使用风险

供应链可用性：完全依赖 Maton 服务的 SLA，无本地降级方案；建议关键业务保留直连第三方 API 的应急通道。

凭证泄露后果：MATON_API_KEY 一旦泄露，攻击者可访问该账户下所有已授权服务，需严格遵循环境变量管理，禁止硬编码。

OAuth 范围失控：用户可能授权过度权限的连接，建议遵循最小权限原则，定期审计 ctrl.maton.ai/connections 中的活跃连接。

网络延迟增加：相比直连第三方 API，增加了一次中转跳数，对延迟敏感场景需实测评估。