CLASSIFIED: OPEN DOSSIER
InnoFlow (智流) API 概览
2026-01-23 Innora Team
# InnoFlow API 概览
InnoFlow (智流) 是 Innora 自研的企业级工作流自动化平台，提供 **30+ 插件模块**、**150+ API Actions**、以及完整的 AI Gateway 能力。
## 平台架构
```
┌──────────────────────────────────────────────────────────┐
│ InnoFlow 控制台 │
├──────────────────────────────────────────────────────────┤
│ 工作流编辑器 │ 连接管理 │ 运行监控 │ 成本面板 │
├──────────────────────────────────────────────────────────┤
│ API Gateway │
├─────────────┬─────────────┬─────────────┬────────────────┤
│ Flows API │ Runs API │ Pieces API │ Webhooks API │
├─────────────┴─────────────┴─────────────┴────────────────┤
│ AI Gateway (可选) │
│ [z.ai] ←→ [智谱 AI] ←→ [OpenAI] ←→ [Circuit Breaker] │
├──────────────────────────────────────────────────────────┤
│ 30+ Pieces (插件模块) │
│ 支付 · 协作 · AI服务 · 云存储 · 企业应用 · 地图 · OCR │
└──────────────────────────────────────────────────────────┘
```
## Base URL
| 环境 | URL |
|------|-----|
| 生产环境 | `https://api.zhiliu.ai/v1` |
| 本地开发 | `http://localhost:8080/api/v1` |
## 认证方式
所有 API 请求需要携带 Bearer Token：
```bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.zhiliu.ai/v1/flows
```
### 获取 API Key
1. 登录 InnoFlow 控制台
2. 进入 **设置** → **API 密钥**
3. 点击 **创建 API Key**
## 核心模块
### 🔧 Pieces (插件模块)
InnoFlow 提供 **30+ 原生插件**，专为中国及亚太市场优化：
| 分类 | 插件 | Actions | Triggers |
|------|------|---------|----------|
| **支付** | 微信支付、支付宝、PayNow | 12 | 4 |
| **协作** | 钉钉、飞书、企业微信 | 18 | 6 |
| **AI** | 通义千问、AI Gateway、OCR | 15 | - |
| **云服务** | 阿里云、腾讯云、华为OBS | 16 | - |
| **企业** | CRM、HR、财务、营销 | 24 | - |
| **地图** | 高德、百度、腾讯地图 | 18 | - |
### 🤖 AI Gateway
企业级 AI 网关，支持智能路由与成本优化：
- **多模型支持**：z.ai GLM-4.7 / 智谱 AI GLM-4 / OpenAI 兼容
- **智能路由**：基于复杂度自动选择最优模型
- **熔断机制**：自动故障转移
- **成本追踪**：按工作流/Agent 统计 Token 消耗
**成本对比**：
| 模型 | 输入成本 | 输出成本 | vs GPT-4 节省 |
|------|----------|----------|--------------|
| z.ai GLM-4.7 | $0.40/M | $1.50/M | **98.7%** |
| 智谱 GLM-4 | ¥0.10/M | ¥0.10/M | **99.6%** |
## API 端点一览
### Flows (工作流)
| 方法 | 端点 | 说明 |
|------|------|------|
| GET | `/flows` | 列出所有工作流 |
| POST | `/flows` | 创建工作流 |
| GET | `/flows/:id` | 获取工作流详情 |
| PUT | `/flows/:id` | 更新工作流 |
| DELETE | `/flows/:id` | 删除工作流 |
| POST | `/flows/:id/publish` | 发布工作流 |
### Runs (执行记录)
| 方法 | 端点 | 说明 |
|------|------|------|
| GET | `/runs` | 列出执行记录 |
| GET | `/runs/:id` | 获取执行详情 |
| GET | `/flows/:id/runs` | 获取工作流执行历史 |
| POST | `/flows/:id/test` | 测试运行 |
### Webhooks
| 方法 | 端点 | 说明 |
|------|------|------|
| POST | `/webhooks/:flowId` | 触发 Webhook 工作流 |
## 响应格式
### 成功响应
```json
{
"data": {
"id": "flow_abc123",
"displayName": "微信支付通知处理",
"status": "enabled"
}
}
```
### 错误响应
```json
{
"error": {
"code": "VALIDATION_ERROR",
"message": "工作流配置无效",
"details": {
"field": "trigger",
"issue": "缺少必填字段"
}
}
}
```
## 速率限制
| Plan | 请求/分钟 | 请求/天 |
|------|-----------|---------|
| Free | 60 | 1,000 |
| Pro | 300 | 50,000 |
| Enterprise | 无限制 | 无限制 |
## 快速入门
```bash
# 1. 列出所有工作流
curl -X GET \
-H "Authorization: Bearer YOUR_API_KEY" \
"https://api.zhiliu.ai/v1/flows"
# 2. 触发 Webhook 工作流
curl -X POST \
-H "Content-Type: application/json" \
-d '{"orderId": "12345", "amount": 9900}' \
"https://api.zhiliu.ai/v1/webhooks/flow_abc123"
```
## 下一步
- [Pieces 插件文档](/docs/innoflow/pieces) - 各插件 Actions 详细说明
- [AI Gateway 文档](/docs/innoflow/ai-gateway) - AI 网关配置与使用
- [Webhook 配置](/docs/innoflow/webhooks) - Webhook 触发器详解