DejaOS 平台开发者指南

DejaOS 是酷豆面向智能门禁终端的物联网操作系统平台，基于 LVGL 图形框架构建现代化人机交互界面，统一管理设备 UI、交互逻辑与渲染参数；在线体验见 dejaos.coolcode.com。

一、开发者接入路径

① 云端开放 API：用于组织同步、权限批量下发、开门/告警记录回传，适合平台级集成；② 设备端 Widget：用于把 AI/交互能力嵌入终端 UI，经 WebSocket 子协议与终端安全握手。

二、云端开放 API（组织同步示例）

先在酷豆云平台创建企业空间，获取 API Key 与设备分组 ID；随后通过「组织同步」接口批量下发人员与权限。下列示例展示一次同步调用的诚实骨架（字段以开放 API 文档为准）：

```js // 伪代码：组织同步批量下发（字段以开放 API 文档为准） const res = await fetch(`${PLATFORM_BASE}/api/v1/org/sync`, { method: "POST", headers: { "Authorization": `Bearer ${API_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ groupId: DEVICE_GROUP_ID, users: [{ id, name, perm }] }) }); ```

三、设备端 Widget 子协议（CoolCode.widget.v1）

Widget 与终端经 WebSocket 握手。浏览器 WebSocket API 无法自定义请求头，握手阶段唯一可携带凭据的通道是 Sec-WebSocket-Protocol。下列示例展示协商 CoolCode.widget.v1 子协议的诚实骨架：

```js // 伪代码：以子协议协商握手（token 经子协议传递，不进 URL） const protocols = ["CoolCode.widget.v1", `kd-token.${btoa(urlSafe(TOKEN))}`]; const ws = new WebSocket("wss://dejaos.coolcode.com/widget", protocols); ws.onopen = () => console.log("subprotocol:", ws.protocol); // 回显 CoolCode.widget.v1 ```

四、集成要点

① 令牌经子协议传递，避免写入 URL 被访问日志记录；② 接口字段与令牌申请以「开放平台 / 产品手册」最新文档为准；③ 对接建议在测试企业空间完成端到端联调后再切生产。