Cloud Services API ReferenceSmart HomeData Dashboard ServiceApp Analytics DataGet Total Activated Devices

Get Total Activated Devices

Last Updated on : 2023-07-28 06:25:38download

Get the total number of activated devices under the current app within the statistical period.

API address

GET: /v1.0/iot-datacenter/app/device/activation/total

Request parameter

Parameter name	Type	IN	Required	Description
params	String	query	true	JSON

Description of params

Parameter name	Type	Required	Description
endDay	String	true	The end of the statistical period.
bizType	String	false	The user domain.
country	String	false	The country or region.
dimension	String	false	The dimension.

Description of dimension

Parameter name	Type	Required	Description
category_code_1	String	false	The first-level category.
category_code_2	Integer	false	The second-level category.
product_id	Integer	false	The product ID.

Return parameter

Parameter name	Type	Description
result	JSONArray	The returned result.

Description of result

Parameter name	Type	Description
activationTotalNum	Integer	The total number of activated devices.
categoryCode1	String	The first-level category.
categoryCode2	String	The second-level category.

Request example

GET: /v1.0/iot-datacenter/app/device/activation/total?params={"startDay":"20210810" ,"endDay":"20210820","dimension":"category_code_1"}

Return example

{
    "result": [
        {
            "categoryCode1": "all",
            "dt": 20210820,
            "activationTotalNum": 1840
        },
        {
            "categoryCode1": "sxj",
            "dt": 20210820,
            "categoryName1": "Security & Video Surveillance",
            "activationTotalNum": 85
        },
        {
            "categoryCode1": "xjd",
            "dt": 20210820,
            "categoryName1": "Small Home Appliances",
            "activationTotalNum": 225
        },
        {
            "categoryCode1": "dgzm",
            "dt": 20210820,
            "categoryName1": "Electrical",
            "activationTotalNum": 131
        },
        {
            "categoryCode1": "hjjk",
            "dt": 20210820,
            "categoryName1": "Exercise & Health",
            "activationTotalNum": 3
        },
        {
            "categoryCode1": "cfdq",
            "dt": 20210820,
            "categoryName1": "Kitchen Appliances",
            "activationTotalNum": 8
        },
        {
            "categoryCode1": "qt",
            "dt": 20210820,
            "categoryName1": "Others",
            "activationTotalNum": 58
        },
        {
            "categoryCode1": "djd",
            "dt": 20210820,
            "categoryName1": "Large Home Appliances",
            "activationTotalNum": 106
        },
        {
            "categoryCode1": "zm",
            "dt": 20210820,
            "categoryName1": "Lighting",
            "activationTotalNum": 304
        }
    ],
    "t": 1630121907084,
    "success": true
}

Error code

For more information, see error code.

Prev DocGet App Device Data

Next DocGet Devices Controlled on the App