2.12、Get Device Online Status

Get Device Online Status

POSTProduction: https://open.eye4cloud.com/{{open_id}}/open/v1/device/getDeviceOnlineStatus
Request Data
Field Name Required Type Description
device_id Yes string Device ID
timestamp Yes int64 Timestamp in seconds
nonce Yes string Random string, 8-20 characters
sign Yes string See "Sign Generation Examples" for the implementation details
password No string Device password; if omitted, the password registered for the device on the Open Platform is used
data No string Device DATA; an empty string can be passed
imei No string Device IMEI; an empty string can be passed
CURL Request Example
CURL
curl 'https://open.eye4cloud.com/{{open_id}}/open/v1/device/getDeviceOnlineStatus' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "xxxx",
    "timestamp": 1758867195,
    "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 object {}
data.code int Device status: 0=unknown, 1=online, 2=offline, 3=device connection timeout
data.message string Device Status

Example:

JSON
{
    "error_code": 0,
    "error_message": "success",
    "error_tips": "",
    "data": {
        "code": 1,
        "message":"ONLINE"
    }
}