api-gateway-zh

Files (1)

• SKILL.md

SKILL.md (first lines)

# API 网关

由 [Maton](https://maton.ai) 提供的透传代理，可通过托管 OAuth 连接直接访问第三方 API。API 网关让您可以直接调用原生 API 端点。

## 快速开始

```bash
# 原生 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
```


## 基础 URL

```
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
```

API 网关会自动为目标服务注入适当的 OAuth 令牌。

**环境变量：** 您可以将 API 密钥设置为 `MATON_API_KEY` 环境变量：

```bash
export MATON_API_KEY="YOUR_API_KEY"
```

## 获取 API 密钥

1. 登录或在 [maton.ai](https://maton.ai) 创建账户
2. 前往 [maton.ai/settings](https://maton.ai/settings)
3. 点击 API Key 部分右侧的复制按钮进行复制

## 连接管理

连接管理使用单独的基础 URL：`https://ctrl.maton.ai`

### 列出连接

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=slack&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**查询参数（可选）：**
- `app` - 按服务名称过滤（例如 `slack`、`hubspot`、`salesforce`）
- `status` - 按连接状态过滤（`ACTIVE`、`PENDING`、`FAILED`）

**响应：**
```json
{
  "connections": [
    {
      "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
      "status": "ACTIVE",
      "creation_time": "2025-12-08T07:20:53.488460Z",
      "last_updated_time": "2026-01-31T20:03:32.593153Z",
      "url": "https://connect.maton.ai/?session_token=5e9...",
      "app": "slack",
      "method": "OAUTH2",
      "metadata": {}
    }
  ]
}
```

### 创建连接

```bash
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'slack'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', 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
```

**请求体：**
- `app`（必需）- 服务名称（例如 `slack`、`notion`）
- `method`（可选）- 连接方式（`API_KEY`、`BASIC`、`OAUTH1`、`OAUTH2`、`MCP`）

### 获取连接

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**响应：**
```json
{

From L-LesterYu/OpenClaw-hot-skills-zh, MIT.

More from L-LesterYu/OpenClaw-hot-skills-zh