API 网关集成路由

解决的问题

在 Agent 工作流里，频繁要跨多个第三方 API 操作：列 Slack 频道、查 Gmail、读 Stripe 客户。每接入一个服务都要处理认证、连接状态、事件监听与写操作风险。手动维护连接和 token 容易遗漏，静默写操作又可能产生不可逆副作用。

核心机制与边界

本技能把这类调用收敛到托管路由 https://api.maton.ai/，通过统一入口访问 Slack、Gmail、Stripe 等应用。关键能力包括：

• 连接管理：创建、列出、获取、删除连接，并用 --connection 指定目标账户。
• 只读优先：先执行 GET 验证账户、资源与状态，再决定是否需要变更。
• 写操作审批：POST、PUT、PATCH、DELETE 前展示连接 ID、端点、请求体与预期结果，等待用户明确批准。
• 触发器与检查点：可监听事件、重放事件，中断后从已处理事件位置恢复，避免重复副作用。
• 多调用入口：支持 maton CLI、JavaScript fetch、Python requests 等方式。

使用时建议从认证检查开始，再列出连接、执行只读查询。对于发邮件、删数据、改计费、创建 Webhook 等高危操作，应逐项确认外部影响。注意它不替代私有网关、OAuth 服务端或 API Key 分发，需要 MATON_API_KEY，并受账户速率限制约束。