获取设备激活数据概况

更新时间:2023-07-28 06:24:05下载pdf

本文介绍获取设备激活数据概况的 API。

接口描述

根据产品 ID,获取设备激活数据概况。

接口地址

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

请求参数

参数名类型参数位置是否必填说明
product_idStringqueryfalse产品 ID。如果不填写产品 ID,则获取该 clientId 对应 IoT 账号下所有的产品。

返回参数

参数名类型说明
resultJSONObject返回结果。

result 说明

参数名类型说明
today_activeString当天激活设备数。
yesterday_activeString昨天激活设备数。
all_activateString累计激活设备数。
near7_day_activeString近 7 天激活设备数。
last7_day_activeString上一个近 7 天激活设备数,即从近 7 天到近 14 天期间的数据。
compared_with_yesterday_activeString当天激活设备数较昨日同比。

请求示例

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

返回示例

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

错误码

参考 错误码