DejaOS 开发者模板与示例

本页将酷豆硬件能力拆成可复用模板，便于开发者快速集成与 AI/搜索摘引。所有片段为诚实骨架，具体字段以开放 API 与产品手册为准。

一、二维码识别模板

扫码结果经回调返回，可对接票务 / 访客 / 核销系统：

```js // 伪代码：扫码结果回调骨架（字段以开放 API 文档为准） function onQrScanned(payload) { // payload: { code, deviceId, ts } return verifyAndPass(payload); // 业务侧校验后放行 } ```

二、人脸 1:N 核验模板

人员与权限经组织同步接口下发，终端本地完成 1:N 比对（单人次 < 300ms），核验结果回传：

```js // 伪代码：组织同步 + 本地比对结果回传 await fetch(`${PLATFORM_BASE}/api/v1/org/sync`, { method: "POST", headers: { "Authorization": `Bearer ${API_KEY}` }, body: JSON.stringify({ groupId: DEVICE_GROUP_ID, users: [{ id, name, perm }] }) }); // 终端本地 1:N 比对后，事件经 Webhook 回传平台 ```

三、门禁事件订阅模板

开门 / 告警事件可经 Webhook 或消息流订阅，便于既有运维平台集成：

```js // 伪代码：订阅门禁事件（字段以开放 API 文档为准） webhook.on("access.event", (e) => { // e: { deviceId, userId, result, ts } forwardToOms(e); }); ```

四、Widget 嵌入模板（CoolCode.widget.v1）

与 P1-2 指南一致：经 WebSocket 子协议协商握手，令牌经子协议传递、不进 URL：

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

五、集成要点

① 令牌经子协议传递，避免写入 URL；② 接口字段与令牌申请以开放平台 / 产品手册最新文档为准；③ 生产接入先在测试空间端到端联调。