Eye4Cloud Open Platform Device Management Documentationv1.1.15

2.1.13 Get Real-Time Device Info (supported only by the new Open Platform firmware)

This API uses real-time device information queries. The device must be online for the query to succeed, and the password is required.

POSTProduction: https://open.eye4cloud.com/{{open_id}}/open/v1/device/getRealtimeDeviceInfo

Request Data

Field Name	Type	Required	Description
device_id	string	Yes	Device ID
timestamp	int64	Yes	Timestamp in seconds
nonce	string	Yes	Random string, 8-20 characters
sign	string	Yes	See "Sign Generation Examples" for the implementation details
imei	string	No	Device IMEI; an empty string can be passed
data	string	No	Custom data; an empty string can be passed
password	string	Yes	Device password

Request Example

JSON

{
    "device_id": "xxx",
    "timestamp": 1755685731,
    "nonce": "dask43hfad",
    "sign": "xxxxxxx",
    "password": ""
}

CURL Request Example

CURL

curl 'https://open.eye4cloud.com/xxxxx/open/v1/device/getRealtimeDeviceInfo' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "xxx",
    "timestamp": 1757472185,
    "nonce": "",
    "sign": "",
    "password": ""
}'

Response Data

Field Name	Type	Description
error_code	int	Status code: 0 indicates success; other values indicate an error
error_message	string	Error message; success indicates a normal response
data.iccid	string	IoT SIM Card Number
data.net_mode	int	Network mode: 0x01 wired, 0x02 WiFi, 0x03 mobile, 0x10 WiFi+mobile, 0x11 wired+WiFi, 0x12 wired+mobile, 0x13 wired+WiFi+mobile
data.power_mode	int	0=constant power; 1=low power
data.sys_ver	string	Firmware Version
data.area	int	Region

Example:

JSON

{
    "error_code": 0,
    "error_message": "success",
    "error_tips": "",
    "data": {
        "iccid": "",
        "net_mode": 2,
        "power_mode": 0,
        "sys_ver": "1.0.1.1",
        "area": 1
    }
}