飞连 icon

飞连

飞连开放平台 API 集成,支持部门与成员、Wi-Fi、终端管理

终端管理 → 获取设备列表

AI-generated

Summary

按用户、设备属性、设备状态、分组 ID 和在线时间筛选飞连终端设备列表。可选择返回全部匹配结果或最多返回指定数量;每个输入项都会触发一次操作调用。

Inputs

  • 用户 ID(id) — 按用户 ID(如 ou_xxx)筛选。
  • 设备 Did(did) — 按设备 Did 筛选。
  • 设备品牌(brand) — 按品牌筛选。
  • 设备名称(device_name) — 按设备名称筛选。
  • 设备 IP(client_ip) — 按设备 IP 筛选。
  • 设备 SN 号(serial_number) — 按设备序列号筛选。
  • 设备 MAC 地址(mac_addrs) — 按 MAC 地址筛选。
  • 客户端版本号(app_ver) — 按客户端版本筛选。
  • 客户端操作系统(client_os) — 按客户端操作系统筛选。
  • 设备状态(status) — 可多选:0 失效设备、1 活跃设备、2 休眠设备;多个状态以逗号分隔。
  • 终端分组 ID(group_id) — 按终端分组筛选;0 表示不传该参数。
  • 首次在线时间范围(created_start_time、created_end_time) — 筛选首次在线时间;任一端留空表示不限制该端。
  • 最近在线时间范围(updated_start_time、updated_end_time) — 筛选最近在线时间;任一端留空表示不限制该端。
  • Return All(returnAll) — 关闭时最多返回 Limit 条;开启时请求全部结果。
  • Limit(limit) — Return All 关闭时的最大结果数,默认 50,可设为 1–200。
  • Timeout(options.timeout) — 等待响应头的超时时间(毫秒);0 表示不限制。

Output shape

一个设备记录列表,作为 n8n 主输出项返回。

实际字段由飞连 API 响应决定;源代码未显式限定记录结构。若启用 Continue On Fail,失败项会输出包含 error 字段的数据。

Links

Discussion