@luka-cat-mimi/n8n-nodes-qingflow-oa

轻流 OA n8n 社区节点，提供轻流开放平台 API 的集成支持。

安装

参考：https://docs.n8n.io/integrations/community-nodes/installation/

节点名称：@luka-cat-mimi/n8n-nodes-qingflow-oa

功能列表

通讯录 - 成员 (7)

• 创建成员
• 批量创建成员
• 获取用户详情
• 通过邮箱或手机号获取成员 userId
• 获取工作区全部成员 ✨ 支持 Return All
• 更新成员
• 删除成员

通讯录 - 部门 (9)

• 创建部门
• 获取部门列表
• 获取部门成员列表
• 获取不在部门的成员
• 查询单个部门详情
• 增加部门成员
• 移除部门成员
• 更新部门
• 删除部门

通讯录 - 角色 (7)

• 创建角色
• 获取角色列表
• 获取角色成员
• 增加角色成员
• 移除角色成员
• 更新角色
• 删除角色

通讯录 - 管理员 (3)

• 增加管理员
• 获取管理员列表
• 删除管理员

通讯录 - 子管理员 (4)

• 创建子管理员
• 获取工作区子管理员配置
• 更新子管理员
• 删除子管理员

轻流应用接口 - 应用管理 (7)

• 创建应用
• 获取工作区所有应用信息
• 获取应用基本信息 ✨ 支持 Return All
• 获取指定应用表单信息
• 获取应用 Word 打印模版信息
• 更新应用基本信息
• 删除应用

数据内容 - 应用数据 (6)

• 获取应用数据 ✨ 支持 Return All
• 获取个人在当前工作区全部事项信息 ✨ 支持 Return All
• 获取单条数据的详细信息
• 获取单条数据的留言信息 ✨ 支持 Return All
• 获取数据关联的内容
• 更新单条数据的信息

数据流程接口 - 流程操作 (6)

• 获取单条数据的流程日志
• 获取某条流程日志的详细信息
• 处理某条数据
• 催办某条数据
• 单条数据重新指派
• 单条数据流程回退

任务委托 (3)

• 新增委托
• 获取委托列表 ✨ 支持 Return All
• 结束委托

高级设置 (1)

• 自定义请求（支持任意 API 端点调用，含批次处理和超时控制）

✨ 特别之处

🔄 Return All 自动分页

以下接口支持 Return All 功能，自动处理分页获取全部数据：

| 模块 | 接口名称 | | -------------------- | ---------------------------------- | | 通讯录 - 成员 | 获取工作区全部成员 | | 轻流应用接口 | 获取应用基本信息 | | 数据内容 - 应用数据 | 获取应用数据 | | 数据内容 - 应用数据 | 获取个人在当前工作区全部事项信息 | | 数据内容 - 应用数据 | 获取单条数据的留言信息 | | 任务委托 | 获取委托列表 |

⏱️ 超时与批次管理

大部分接口支持以下高级选项：

• Timeout（超时时间）：设置请求超时时间（毫秒），避免请求长时间挂起
• Batching（批次管理）：
  • Items per Batch：每批处理的数量，用于控制请求频率
  • Batch Interval (ms)：每批请求之间的等待时间，避免触发 API 限流

这些功能可在接口的 Options 选项中配置，有效应对轻流 API 的频率限制。

🔐 智能 Token 刷新

轻流 OA API 有一个特殊设计：即使请求失败，服务器也会返回 HTTP 200 状态码，错误信息通过响应体中的 errCode 字段返回。本节点自动检测 errCode: 49300（Token 已过期），自动刷新 Access Token 并重试请求。

凭证类型

• 轻流 OA API 凭证 - 使用 API Key 进行认证

配置说明

| 字段 | 说明 | 示例 | | ------------ | ------------------------ | --------------------------------- | | Base URL | 轻流 OA 的 API 基础地址 | https://api.singleflow.com | | API Key | 轻流 OA 的 API 密钥 | your_api_key | | User ID | 默认用户 ID（可选） | default_user_id |

Base URL 说明

根据部署环境选择对应的地址：

• 公有云：https://api.singleflow.com
• 专有云：https://xxx.xxx.com/openApi

注意事项

1. API Key 获取：登录轻流 OA 管理后台 → API 管理页面 → 创建或查看 API 密钥
2. 错误码查询：轻流 API 文档

📝 许可证

MIT License

🆘 支持

• 📧 邮箱：[email protected]
• 🐛 问题反馈