GS/GE 类设备对接文档

版本：V1.0.7

源文档更新时间：2025-12-09

本文按《GS_GE类设备对接文档V1.0.7》整理，适用于 GS3 4G 拍照烟感和 GE1 拉绳报警器。总览只保留接入范围、流程和导航；接口字段与请求示例请以左侧对应专题为准。

适用设备

设备型号 设备说明
GS3 4G 拍照烟感
GE1 拉绳报警器

接入流程

  1. 确认设备交付后，设备 ID 已存在于小鹰开放平台。
  2. 联系开放平台管理员获取 appid/openid 和 secret_key。
  3. 提供 HTTPS 回调 API，接收设备上报事件。
  4. 服务端根据 V1.0.7 规则生成 sign，并校验回调请求。
  5. 按业务处理设备重置、告警、心跳、低电、图片和移动侦测事件。
  6. 通过统一指令地址向设备下发停止报警、值守时间和灵敏度配置。

secret_key 只能保存在服务端或安全配置中心，不能放在前端、App、小程序或其他外部请求中。

文档导航

文档 关键内容
适用范围与设备型号 GS3 4G 拍照烟感、GE1 拉绳报警器
对接准备 设备 ID、appid/openid、secret_key
接收设备上报 HTTPS POST 回调、签名校验、返回值
设备重置 <code>origin_info.cmd=reset_signal</code>
设备告警 <code>origin_info.cmd=call</code>、真实与测试告警
设备心跳 <code>origin_info.cmd=info</code>、设备状态信息
低电告警 事件标识 <code>info</code>、<code>cmd=low_power_warning</code>
图片事件 事件标识 <code>picture</code>、图片 Buffer
防拆告警 <code>origin_info.cmd=demolition_alarm</code>
移动侦测 <code>origin_info.cmd=motion_detection</code>
向设备下发指令 <code>/open/v1/device/command</code>
停止报警 <code>cmd=stop_alarm</code>
移动侦测值守时间 <code>cmd=motion_detection_config</code>
移动侦测灵敏度 <code>cmd=PIR_sensitivity</code>
人形侦测 平台参数配置

版本历史

版本 更新日期 更新说明 编制人
V1.0.7 2025-12-09 调整文档上报数据结构问题 严永龙
V1.0.6 2025-09-25 增加 GE1 活动监测相关描述 严永龙
V1.0.5 2025-09-23 优化事件转发和指令接收时的 sign 生成，增加 timestamp 和 nonce 加强安全性 陈鲁彬、严永龙
V1.0.4 2025-08-16 添加 Java 生成 sign 的示例代码 陈鲁彬
V1.0.3 2025-08-13 添加开启人形侦测的说明 陈鲁彬
V1.0.2 2025-04-18 新增加 appid；默认不开启移动侦测；支持使用 IMEI 作为设备唯一标识 陈鲁彬
V1.0.1 2025-03-27 接口新增 IMEI 参数，心跳和告警支持返回温度、浓度、rsrp、rsrq 等设备信息 陈鲁彬
V1.0.0 2025-03-26 新建文档 陈鲁彬