Cloud Services API ReferenceSmart HomeData Dashboard ServiceBasic DataGet an Overview of Activated Device Data

Get an Overview of Activated Device Data

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

Get an overview of activated device data based on the product ID.

API address

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

Request parameter

Parameter name	Type	IN	Required	Description
product_id	String	query	false	The product ID (PID). If you do not set the parameter, all products under the specified IoT account of this `clientId` are returned.

Return parameter

Parameter name	Type	Description
result	JSONObject	The returned result.

Description of result

Parameter name	Type	Description
today_active	String	The number of devices activated today.
yesterday_active	String	The number of devices activated yesterday.
all_activate	String	The total number of activated devices.
near7_day_active	String	The number of devices activated in the last seven days.
last7_day_active	String	The number of devices activated within the seven days starting from 14 days ago.
compared_with_yesterday_active	String	The difference between the number of devices activated today and that of yesterday.

Request example

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

Return example

{
    "result": {
        "last7_day_active": "8",
        "all_activate": "5237",
        "near7_day_active": "2",
        "today_active": "0",
        "yesterday_active": "0"
    },
    "t": 1545278901275,
    "success": true
}

Error code

For more information, see error code.

Prev DocGet Regional Distribution Details

Next DocGet Total Activation Data Trend