SuperAPI AI 工具集

unifi-operator

通用与其它

查看项目

更新于 10-16 03:39

技能介绍

用途:在本地 UniFi OS 控制台上通过 HTTP 操作 Network 与 Protect 两个应用,不涉及云端 Site Manager。官方集成 API 使用 X-API-KEY 无状态认证;私有 API 需本地管理员账号登录获取 Cookie TOKEN 与 CSRF 令牌。

主要能力:Network 侧可管理网关、交换机、AP、客户端、VLAN、WLAN、防火墙、路由、端口转发、DPI、访客/热点凭证及设备接纳与生命周期;Protect 侧可管理摄像头、录像、快照、智能检测事件、灯光、传感器、门铃、警报器与实时更新。官方 API 覆盖约六到七成,稳定且跨升级;私有 API 覆盖接近百分之百,但不受支持且随版本变化。

使用方式:所有接口位于 443 端口,使用自签名证书,curl 需加 -k。官方示例:curl -ksS -H "X-API-KEY: $KEY" https://$HOST/proxy/network/integration/v1/info。私有需先登录获得 CSRF,例如 POST https://$HOST/api/auth/login 并保存 cookie,后续变更请求携带 x-csrf-token。站点路径使用 self/sites 返回的内部 slug(常为 default),而非显示名称。

限制:云 SSO 或启用 MFA 的账号无法用于脚本登录,需本地非 MFA 管理员;私有接口路径可能随固件变动或在部分版本返回错误;变更请求漏带 CSRF 令牌会 401;编辑资源需用 PUT 而非 POST,否则会创建重复项;不应轮询 /bootstrap,应改用 /ws/updates 增量套接字。费用、价格与部署平台等资料暂未提供。