Get Devices Controlled on the App

Last Updated on : 2023-06-15 05:10:00

Get the number of users who control the devices on the app, and the number of device cotnrols on the app.

API address

GET: /v1.0/iot-datacenter/app/device/control

Request parameter

Parameter name	Type	IN	Required	Description
params	String	query	true	JSON

Description of params

Parameter name	Type	Required	Description
bizType	String	false	The user domain.
startDay	String	true	The start time.
endDay	String	true	The end time.
country	String	false	The country or region.
dimension	String	false	The dimension. Optional.

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.
control_type	Integer	false	The device control method.

Return parameter

Parameter name	Type	Description
result	JSONArray	The returned result.

Description of result

Parameter name	Type	Description
uidCnt	Integer	The number of users.
useCnt	Integer	The times of control.
dt	Integer	The date.

Request example

GET: /v1.0/iot-datacenter/app/device/control?params={"startDay":"20210817" ,"endDay":"20210820","dimension":"category_code_2"}

Return example

{
    "result": [
        {
            "productId": "waznuxxxxzec5m",
            "uidCnt": 1,
            "productName": "Tuya_SmartCamera_Demo",
            "dt": 20210817,
            "usedCnt": 9
        },
        {
            "productId": "waznupxxxxgzec5m",
            "uidCnt": 1,
            "productName": "Tuya_SmartCamera_Demo",
            "dt": 20210818,
            "usedCnt": 9
        },
        {
            "productId": "mab2xxxxpawoui1",
            "uidCnt": 1,
            "productName": "Tuya_Erluchapai_Demo",
            "dt": 20210819,
            "usedCnt": 2
        },
        {
            "productId": "waznuxxxxec5m",
            "uidCnt": 1,
            "productName": "Tuya_SmartCamera_Demo",
            "dt": 20210819,
            "usedCnt": 9
        },
        {
            "productId": "qpnghxxxxxtsu5s",
            "uidCnt": 3,
            "productName": "Tuya_RBGLight_Demo",
            "dt": 20210820,
            "usedCnt": 3
        },
        {
            "productId": "q4ely8xxxxxulbh",
            "uidCnt": 1,
            "productName": "Tuya_Socket_Demo",
            "dt": 20210821,
            "usedCnt": 1
        },
        {
            "productId": "0kfxxxxxxaac3h",
            "uidCnt": 2,
            "productName": "Tuya_Light_Demo",
            "dt": 20210822,
            "usedCnt": 2
        },
        {
            "productId": "bovoxxxxxthuygf",
            "uidCnt": 1,
            "productName": "Tuya_RobotVacuum_Demo",
            "dt": 20210823,
            "usedCnt": 6
        }
    ],
    "t": 1630135735402,
    "success": true
}

Error code

For more information, see error code.

Prev DocGet Total Activated Devices

Next DocGet Registered Users