GS/GE Device Integration Documentation

Version: V1.0.7

Source document updated: 2025-12-09

This section is organized from the GS_GE Device Integration Documentation V1.0.7 and applies to the GS3 4G photo smoke detector and GE1 pull-cord alarm device. The overview contains only scope, workflow, and navigation. Use the corresponding topic on the left as the source of truth for API fields and request examples.

Supported Devices

Device Model Device Description
GS3 4G Photo Smoke Detector
GE1 Pull-cord Alarm Device

Integration Workflow

  1. After confirming device delivery, make sure the Device ID exists on the Eye4Cloud Open Platform.
  2. Contact the Open Platform administrator to obtain appid/openid and secret_key.
  3. Provide an HTTPS callback API to receive device report events.
  4. The server generates sign according to the V1.0.7 rules and verifies callback requests.
  5. Handle device reset, alarms, heartbeat, low-battery, picture, and motion detection events according to your business needs.
  6. Send stop-alarm commands, arming schedules, and sensitivity settings to the device through the unified command URL.

secret_key must be stored only on the server or in a secure configuration center. Do not place it in a frontend, app, mini program, or other external request.

Documentation Navigation

Documentation Key Content
Scope & Device Models GS3 4G Photo Smoke Detector、GE1 Pull-cord Alarm Device
Integration Preparation Device ID、appid/openid、secret_key
Receive Device Reports HTTPS POST callbacks, signature verification, and return values
Device Reset <code>origin_info.cmd=reset_signal</code>
Device Alarms <code>origin_info.cmd=call</code>; real and test alarms
Device Heartbeat <code>origin_info.cmd=info</code>; device status information
Low Battery Alarm Event identifier <code>info</code>, <code>cmd=low_power_warning</code>
Picture Events Event identifier <code>picture</code>, image Buffer
Anti-tamper Alarm <code>origin_info.cmd=demolition_alarm</code>
Motion Detection <code>origin_info.cmd=motion_detection</code>
Send Commands to Device <code>/open/v1/device/command</code>
Stop Alarm <code>cmd=stop_alarm</code>
Motion Detection Arming Schedule <code>cmd=motion_detection_config</code>
Motion Detection Sensitivity <code>cmd=PIR_sensitivity</code>
Human Detection Platform Parameter Configuration

Version History

Version Update Date Change Description Author
V1.0.7 2025-12-09 Adjusted the reported data structure Yan Yonglong
V1.0.6 2025-09-25 Added descriptions for GE1 activity monitoring Yan Yonglong
V1.0.5 2025-09-23 Improved sign generation for event forwarding and command reception by adding timestamp and nonce for stronger security Chen Lubin and Yan Yonglong
V1.0.4 2025-08-16 Added a Java sign generation code example Chen Lubin
V1.0.3 2025-08-13 Added instructions for enabling Human Detection Chen Lubin
V1.0.2 2025-04-18 Added appid; Motion Detection is disabled by default; IMEI can be used as the unique device identifier Chen Lubin
V1.0.1 2025-03-27 Added the IMEI parameter to the API; heartbeat and alarm responses now support temperature, concentration, rsrp, rsrq, and other device information. Chen Lubin
V1.0.0 2025-03-26 Created documentation Chen Lubin