云服务 API 参考全屋智能数据星象仪APIApp分析数据获取 App 控制设备数据

获取 App 控制设备数据

更新时间：2023-07-28 06:25:50下载pdf

本文介绍获取 App 控制设备数据的 API。

接口描述

获取 App 控制设备用户数以及获取 App 控制设备的次数。

接口地址

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

请求参数

参数名	类型	参数位置	是否必填	说明
params	String	query	true	JSON

params 说明

参数名	类型	是否必填	说明
bizType	String	false	用户域
startDay	String	true	开始时间
endDay	String	true	结束时间
country	String	false	国家
dimension	String	false	维度，可选字段如下维度说明

dimension 说明

参数名	类型	是否必填	说明
category_code_1	String	false	一级品类
category_code_2	Integer	false	二级品类
product_id	Integer	false	产品
control_type	Integer	false	控制方式

返回参数

参数名	类型	说明
result	JSONArray	返回结果

result 说明

参数名	类型	说明
uidCnt	Integer	用户数
useCnt	Integer	控制次数
dt	Integer	日期

请求示例

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

返回示例

{
    "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
}

错误码

参考错误码。

上一篇获取累计激活设备数

下一篇获取 App 注册用户数据