Cloud Services API ReferenceSmart HomeData Dashboard ServiceBasic DataGet Data Overview of Active Devices

Get Data Overview of Active Devices

Last Updated on : 2023-07-28 06:24:28download

Get the data of active devices under the specified product based on the product ID.

API address

GET: /v1.0/devices/live-datas-survey

Request parameter

Parameter name	Type	IN	Required	Description
product_id	String	query	false	The product ID. If you do not set the parameter, all your product IDs will be returned.

Return parameter

Parameter name	Type	Description
result	Object	The returned result.

Description of result

Parameter name	Type	Description
today_live	String	The number of active devices today.
yesterday_live	String	The number of active devices yesterday.
near7_day_live	String	The number of active devices in the last seven days.
last7_day_live	String	The number of devices active within the seven days starting from 14 days ago.
compared_with_yesterday_live	String	The ratio of today's active devices to yesterday's active devices. A value of `2` means that the number of today's active devices is twice that of yesterday.
rate_of_today_live	String	The number of active devices today divided by total activated devices.

Request example

GET: /v1.0/devices/live-datas-survey?product_id=123

Return example

{
    "result": {
        "last7_day_live": "129",
        "today_live": "99",
        "yesterday_live": "102",
        "near7_day_live": "108",
        "rate_of_today_live": "1.89%"
    },
    "t": 1545278810104,
    "success": true
}

Error code

For more information, see error code.

Prev DocGet data of custom interface

Next DocGet Overview of App Device Data