创客工坊人体活动监测：怎么将HTTP接口人体存在检测设备对接到软件项目中_解决方案

CATALOG

芯步的人体存在传感器采用红外+雷达双模检测，当有人/无人状态变化时会主动向你的服务器推送数据。以下方案涵盖从接口配置、消息推送到签名验证的完整对接流程，可直接用于实际项目中。

1. 解决概述

在创客工坊或智能办公场景中，人体活动监测是实现自动化节能、安防监控和智能联动的核心环节。芯步的智能人体存在传感器（如吸顶/壁挂雷达版）采用了 红外+雷达双模检测 技术，能够精准识别细微动作（如打字、呼吸），避免了传统红外传感器因静坐导致的“误判无人”问题。

本方案的目标是指导开发者如何通过芯步开放的 HTTP API，在 30分钟 内将硬件设备无缝集成到您现有的软件系统（Web、APP、小程序或本地化软件）中。我们将采用 “设备主动推送 + 服务器被动接收” 的异步架构，确保实时性与低耦合。

2. 核心技术原理与架构

芯步的传感器不同于普通的WiFi插座（需要实时等待指令），作为数据采集类设备，它们遵循 “状态变化即上报” 的原则。

上行消息（核心） ：当传感器检测到“有人”或“无人”状态变化时，它会主动向您指定的服务器地址发送HTTP POST请求。
下行指令（控制） ：您的服务器可以主动向设备发送指令（如开启/关闭传感器内部的雷达模块、调节灵敏度等）。

架构图逻辑：

人体存在传感器 ---(HTTP Post 状态变化)---> 您的业务服务器 ---(WebSocket/SSE)---> 前端界面（实时展示）

3. 前置准备：设备注册与服务器配置

在编写代码前，您需要在芯步物联网平台完成基础配置。

注册与创建应用：登录芯步控制台，创建一个新应用（如“工坊监测系统”）。系统会生成唯一的 AppId 和 AppSecret，这是后续API调用的钥匙。
获取设备ID：将购买的“人体存在传感器”配网并绑定到您的账号下。在设备列表中找到该设备，记录其唯一的 Device ID（例如代码示例中的 820720）。
配置消息推送URL（最关键的一步） ：
- 在控制台的“开发设置”中，找到“消息推送”配置项。
- 将您的 服务器公网地址 填入，例如：http(s)://yourdomain.com/api/sensor/callback。
- 注意：如果是在本地电脑测试，可以使用内网穿透工具（如ngrok）生成一个公网URL进行调试。

4. 实战对接一：接收“有人/无人”状态（Webhook 接入）

传感器的数据是通过HTTP请求主动“推”过来的，因此您不需要写代码去“查”，只需要写一个接口去“收”。

4.1 接口设计（示例：Python Flask / Node.js）

您需要在后端创建一个路由，对应在平台配置的URL。

请求特征

Method：POST
Content-Type：application/json
Body内容示例（根据文档推测，实际请以控制台抓包为准）：
{ "device_id": "820720", "msg_type": "status_report", "data": { "presence": "someone", // 状态: someone 或 none "illuminance": 320, // 可选:有的型号带光照度 "timestamp": 1678932123 }, "sign": "xxxxxx" }

4.2 代码实现逻辑

你需要解析这个JSON，并处理业务逻辑。

Python (Flask) 示例：

5. 实战对接二：主动查询与控制（API 调用）

除了被动接收，您可能需要在软件界面上手动控制传感器（例如关闭检测功能以避免误报）。

芯步的API采用 签名校验 机制。请求地址格式为：http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

5.1 签名生成算法

这是防止接口被恶意攻击的关键。签名为双重MD5加密：

将您的 AppSecret 进行一次MD5加密。
将上述结果拼接上当前的Unix时间戳（秒）。
将拼接后的字符串再次进行MD5加密。

代码示例（Node.js / JavaScript）：

const crypto = require('crypto');
const axios = require('axios');

const AppId = "YOUR_APP_ID";
const AppSecret = "YOUR_APP_SECRET";
const DeviceId = "820720";

function generateSign() {
    const ts = Math.floor(Date.now() / 1000); // 获取秒级时间戳
    // 第一步:md5(AppSecret)
    const md5Secret = crypto.createHash('md5').update(AppSecret).digest('hex');
    // 第二步:拼接 md5(AppSecret) + ts
    const signStr = md5Secret + '.' + ts;
    // 第三步:md5(拼接字符串)
    const sign = crypto.createHash('md5').update(signStr).digest('hex');
    return { sign, ts };
}

async function controlDevice(command, value) {
    const { sign, ts } = generateSign();
    const url = `https://api.thingboot.com/${AppId}/device/control/?sign=${sign}&ts=${ts}`;
    
    // order 参数里放具体命令，例如开启雷达模块
    const payload = {
        device: DeviceId,
        order: { "radar_enable": value } // 1开启，0关闭
    };
    
    try {
        const response = await axios.post(url, payload);
        console.log("控制成功:", response.data);
    } catch (error) {
        console.error("控制失败:", error.response.data);
    }
}

// 场景:工坊下班时间，远程关闭传感器以省电
controlDevice("radar_enable", 0);

6. 安全加固：回调接口的签名验证

在步骤4中，为了防止恶意伪造请求，您的接收接口应当验证请求携带的签名，确认数据确实来自芯步平台，而不是黑客的模拟请求。

验证逻辑如下：

从HTTP Header或Body中提取 sign 和 ts（时间戳）。
检查当前时间与 ts 的差值是否在合理范围内（如5分钟内），防重放攻击。
使用步骤5中同样的MD5算法，结合您的 AppSecret 计算签名。
对比计算结果与请求中的 sign 是否一致。

7. 创客工坊应用场景拓展

将数据接入软件项目后，您可以发挥想象力实现以下高级功能：

智能省电系统：结合工坊的打卡系统，当“最后一个人离开（无人状态持续10分钟）”且“下班时间后”，自动通过API调用切段工坊总电源或关闭非必要设备。
工位利用率分析：将长期收集的“有人/无人”数据存入数据库，生成热力图，分析工坊哪些区域最受欢迎，哪些区域闲置。
低代码/大屏展示：利用支持HTTP请求的低代码平台（如Node-RED、Vue大屏），直接读取传感器状态或接收推送，制作一个3D可视化工坊地图，实时高亮显示谁在工作区。
局域网/私有化部署：对于保密性比较高的创客项目，芯步支持私有化部署，设备数据可以直接推送到局域网内的服务器，不经过外网，保障代码和数据安全。

8. 总结

通过对接芯步的HTTP接口，您无需具备底层的嵌入式开发知识，只需具备基础的HTTP请求处理能力（任何编程语言均可），即可完成硬件与软件的融合。核心流程概括为：配网注册 -> 设置回调URL -> 编写接收逻辑 -> 实现双向控制。这一方案将为您的创客项目赋予强大的空间感知能力。