API Gateway Universal

将 Bot 连接到任意外部 API，仅需极少配置。一个统一位置，集中管理全部集成。

概念

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│    Bot      │ ──► │  API        │ ──► │  External   │
│  (Command)  │     │  Gateway    │     │  APIs       │
└─────────────┘     └─────────────┘     └─────────────┘
                           │
                    ┌──────┴──────┐
                    │ • Auth      │
                    │ • Cache     │
                    │ • Rate Limit│
                    │ • Retry     │
                    └─────────────┘

命令

配置 API

# 添加新 API
api add weather
  --base:https://api.openweathermap.org/data/2.5
  --auth:query:appid:$WEATHER_API_KEY

# 添加 Endpoint
api endpoint weather current
  --path:/weather
  --params:q,units

# 列出已配置的 API
api list

调用 API

# 调用 Endpoint
api call weather current --q:"Mexico City" --units:metric

# 直接通过 URL 调用
api get https://api.example.com/data

# POST 请求（含 body）
api post https://api.example.com/create --body:'{"name":"test"}'

管理

# 查看统计信息
api stats weather

# 查看日志
api logs --last:10

# 测试连接
api test weather

示例：配置天气 API

# apis/weather.yaml
name: weather
base_url: https://api.openweathermap.org/data/2.5
auth:
  type: query
  param: appid
  value: ${WEATHER_API_KEY}
  
endpoints:
  current:
    path: /weather
    method: GET
    params:
      - q: string  # city
      - units: metric|imperial
    cache: 10m
    
  forecast:
    path: /forecast
    method: GET
    params:
      - q: string
      - cnt: number  # days

配置完成后的使用示例

用户：墨西哥城的天气

Bot：🌤️ 墨西哥城当前天气：
     
     🌡️ 温度：22°C
     💧 湿度：45%
     💨 风速：12 km/h
     🌅 体感温度：24°C

认证类型

功能特性

缓存（Caching）

endpoints:
  data:
    cache: 15m  # 15 分钟缓存

限流（Rate Limiting）

rate_limit:
  requests: 100
  period: 1h

自动重试（Retry Automático）

retry:
  attempts: 3
  backoff: exponential

预配置 API

集成能力

• proactive-triggers：在自动化流程中调用 API
• daily-digest：从多个 API 获取数据
• multi-agent：各 Agent 可复用已配置的 API