Description

@luka-cat-mimi/n8n-nodes-feilian

飞连 n8n 社区节点，提供飞连开放平台 API 的集成支持，覆盖事件订阅 Webhook 触发、部门与成员管理、Wi-Fi 管理、终端管理、软件管理等场景。

安装

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

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

功能列表

飞连 Webhook Trigger

通过 Webhook 接收飞连事件订阅回调。将节点生成的 URL 配置到飞连管理后台「系统设置 – 集成管理 – 事件订阅」的请求地址中。

主要特点：

• 固定 POST，自动处理首次 URL 验证（url_verification），返回完整 challenge JSON
• 支持 Verification Token 校验；可选 Encrypt Key，按 AES-256-CBC 解密加密推送
• 兼容 JSON body 与 application/octet-stream 文件推送
• 默认订阅所有事件，也可按 header.event_type 多选过滤；未匹配事件返回 HTTP 200 但不触发工作流

支持的事件：

| 事件名称 | Event Key |
| — | — |
| 所有事件 | * |
| 部门新建 | department.v1.create |
| 部门信息变更 | department.v1.update |
| 部门被删除 | department.v1.delete |
| 新员工入职 | user.v1.create |
| 员工信息变更 | user.v1.update |
| 员工账号激活 | user.activation.v1.update |
| 员工账号状态变更 | user.status.v1.update |
| 角色被删除 | role.v1.delete |
| 用户登录认证 | auth.v1.login |
| 审批实例状态变更 | approval.v1.instance.status.update |
| 审批节点操作变更 | approval.v1.instance.node.action |
| 短信通知 | notify.v1.sms |
| 可信设备签发证书 | asset.trusteddevice.v1.createcert |
| 可信设备状态变更 | asset.trusted_device.v1.status |

> 请先激活工作流，再在飞连后台保存请求地址，以便完成 URL 有效性验证。

部门与成员 (18)

• 获取部门列表
• 根据名称获取部门 ID
• 获取用户详情
• 邮箱或手机换用户信息
• 姓名换用户信息
• 批量查询用户详情
• 邮箱或手机批量获取用户 ID
• 获取某个部门的成员（支持递归子部门成员）
• 获取部门数和用户数
• 重置用户密码
• 创建角色
• 获取角色列表
• 获取角色详情（支持自动分页获取角色成员）
• 更新角色基本信息
• 删除角色
• 添加角色成员
• 更新角色成员
• 删除角色成员

Wi-Fi (12)

• 获取哑终端列表
• 批量创建哑终端
• 更新哑终端
• 批量删除哑终端设备
• 获取哑终端设备类型列表
• 创建哑终端设备类型
• 更新哑终端设备类型
• 批量删除哑终端设备类型
• 获取哑终端连接日志
• 获取员工 Wi-Fi 的连接日志
• 查看员工的 Wi-Fi 启用状态
• 获取访客 Wi-Fi 的连接日志

终端管理 (5)

• 获取设备列表
• did 换设备信息
• 获取设备登陆日志
• 获取对应设备的软件列表
• 获取设备大盘信息

软件管理 (10)

• 软件列表
• 软件安装详情
• 获取软件安装用户的使用时长
• 获取终端上报软件列表
• 获取软件许可管理列表
• 添加许可管理软件
• 更新软件许可管理信息
• 获取软件许可授权详情
• 添加软件许可授权对象
• 移除软件许可授权对象

✨ 特别之处

🔄 Return All 自动分页

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

| 模块 | 接口名称 |
| ———- | ————————- |
| 部门与成员 | 获取某个部门的成员 |
| 部门与成员 | 获取角色详情 |
| Wi-Fi | 获取哑终端列表 |
| Wi-Fi | 获取哑终端设备类型列表 |
| Wi-Fi | 获取哑终端连接日志 |
| Wi-Fi | 获取员工 Wi-Fi 的连接日志 |
| Wi-Fi | 获取访客 Wi-Fi 的连接日志 |
| 终端管理 | 获取设备列表 |
| 终端管理 | 获取设备登陆日志 |
| 终端管理 | 获取对应设备的软件列表 |
| 软件管理 | 软件列表 |
| 软件管理 | 软件安装详情 |
| 软件管理 | 获取软件安装用户的使用时长 |
| 软件管理 | 获取终端上报软件列表 |
| 软件管理 | 获取软件许可管理列表 |
| 软件管理 | 获取软件许可授权详情 |

⏱️ 超时与批次管理

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

• Timeout（超时时间）：设置请求超时时间（毫秒），避免请求长时间挂起
• Batching（批次管理）：

– Items per Batch：每批处理的数量，用于控制请求频率
– Batch Interval (ms)：每批请求之间的等待时间，避免触发 API 限流

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

凭证类型

• 飞连 API 凭证 – 使用飞连开放平台的 API Key 和 API Secret 进行认证

注意事项

1. 使用 API 节点前需要在飞连开放平台创建应用并获取 API Key 和 API Secret
2. 部分接口需要相应的权限配置
3. 使用 Webhook Trigger 时需填写事件订阅的 Verification Token；若开启加密推送，还需填写 Encrypt Key

📝 许可证

MIT License

🆘 支持

• 📧 邮箱：luka.cat.mimi@gmail.com
• 🐛 问题反馈