Get Total Activated Devices

Last Updated on : 2023-06-15 05:09:57

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 nameTypeINRequiredDescription
paramsStringquerytrueJSON

Description of params

Parameter nameTypeINRequiredDescription
endDayString trueThe end of the statistical period.
bizTypeString falseThe user domain.
countryString falseThe country or region.
dimensionString falseThe dimension.

Description of dimension

Parameter nameTypeINRequiredDescription
category_code_1String falseThe first-level category.
category_code_2Integer falseThe second-level category.
product_idInteger falseThe product ID.

Return parameter

Parameter nameTypeDescription
resultJSONArrayThe returned result.

Description of result

Parameter nameTypeDescription
activationTotalNumIntegerThe total number of activated devices.
categoryCode1StringThe first-level category.
categoryCode2StringThe 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.