API Gateway 是一个直通式（passthrough）代理技能，由 Maton 提供，用于通过托管 OAuth 连接直接访问第三方 API。它允许调用目标服务的原生 API 端点，而不是封装后的抽象接口。
用途 该技能面向需要统一接入多个第三方服务的场景。借助托管 OAuth 连接，用户无需为每个服务单独实现授权流程，即可直接调用其原生 API。资料中列举了 100+ 服务，包括 Google Workspace、Microsoft 365、GitHub、Notion、Slack、Airtable、HubSpot 等。
主要能力
- 直通代理：以原生 API 路径调用第三方服务。
- 托管 OAuth：由网关自动注入目标服务所需的 OAuth 令牌。
- 连接管理：列出、创建、获取、删除连接；可按应用与状态过滤。
- 多连接选择：通过 Maton-Connection 头指定具体连接；若省略，则使用该应用默认（最早创建）的活动连接。
- 路由参考：提供按服务商划分的详细路由指南，覆盖各服务可访问的资源类别（如联系人、任务、消息、文件等）。
使用方式 基址格式为 https://gateway.maton.ai/{app}/{native-api-path}。其中 {app} 为服务名称，{native-api-path} 为实际 API 端点路径。资料强调 URL 路径必须以连接的应用名开头（例如 /google-mail/...），该前缀用于告知网关使用哪个应用连接。例如原生 Gmail API 路径以 gmail/v1/ 开头，完整路径形如 /google-mail/gmail/v1/users/me/messages。
认证：所有请求需在 Authorization 头中提供 Maton API 密钥：Authorization: Bearer $MATON_API_KEY。可通过环境变量设置：export MATON_API_KEY="YOUR_API_KEY"。获取密钥的步骤为：在 maton.ai 登录或注册账号，前往 maton.ai/settings，点击 API Key 区域右侧的复制按钮。
连接管理使用独立基址 https://ctrl.maton.ai，同样需要 Authorization 头。列出连接时可使用可选查询参数 app（按服务名过滤，如 slack、hubspot、salesforce）和 status（按连接状态过滤，如 ACTIVE、PENDING、FAILED）。创建连接需提交请求体，其中 app 为必填（服务名），method 为可选（API_KEY、BASIC、OAUTH1、OAUTH2、MCP）。获取连接返回的 URL 需在浏览器中打开以完成 OAuth。删除连接使用 DELETE 方法。
若同一应用存在多个连接，可在请求中添加 Maton-Connection 头并附上连接 ID 以指定使用的连接。
示例代码（Slack 原生 API 调用）：
python <<'EOF' import urllib.request, os, json data = json.dumps({'channel': 'C0123456', 'text': 'Hello from gateway!'}).encode() req = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
适用场景 适用于需要在脚本或自动化流程中直接调用多个 SaaS、办公与协作平台原生 API 的任务，例如读写 Airtable 记录、在 Slack 发消息、访问 GitHub 仓库、操作 Google Drive 文件、查询 Salesforce 数据等。资料中按服务列出了可访问的资源类型，可作为选择服务的依据。
限制与说明 资料未提供计费方式、价格、速率限制、配额、可用地区、服务水平协议等信息，这些内容暂未提供。使用前需自行获取 Maton API 密钥并完成对应应用的连接创建与 OAuth 授权。调用时必须遵守目标服务自身的 API 规则；资料未说明网关对错误处理、重试或日志的具体行为。