第三方API网关

技能简介

API Gateway是由Maton提供的托管式API代理服务，支持通过单一入口调用100+第三方服务的原生API，包括Google Workspace、Microsoft 365、Notion、Slack、Airtable、HubSpot等。该服务自动处理OAuth认证流程，用户只需维护一个MATON_API_KEY即可访问所有已授权的外部服务。

能做什么

• 直接调用第三方服务的原生API端点
• 统一管理多服务的OAuth连接状态
• 创建、查询、删除服务连接
• 自动注入目标服务的有效OAuth令牌

使用说明

安装与配置

1. 访问maton.ai注册或登录账号
2. 进入设置页面获取API Key
3. 设置环境变量：export MATON_API_KEY="YOUR_API_KEY"

发起API调用

基础URL格式为https://gateway.maton.ai/{app}/{native-api-path}，请求头需包含Authorization: Bearer $MATON_API_KEY。网关会自动匹配对应服务的OAuth令牌。

Python示例（Slack发消息）

import urllib.request, os, json
data = json.dumps({'channel': 'C0123456', 'text': 'Hello!'}).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.load(urllib.request.urlopen(req)))

连接管理

使用控制端点https://ctrl.maton.ai管理连接：列出连接（GET /connections）、创建连接（POST /connections）、获取/删除指定连接（GET/DELETE /connections/{id}）。创建连接后需打开返回的URL完成OAuth授权。

输入与输出

见下方输入与输出表格。

风险提示

• MATON_API_KEY仅用于Maton平台认证，不直接授予任何第三方服务权限
• 每个第三方服务需单独完成OAuth授权流程
• 访问范围严格限定为用户已授权的连接
• 多连接场景需显式指定connection_id避免歧义

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/byungkyu/api-gateway/SKILL.md
来源类型：GitHub仓库