获取设备激活数据概况

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

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

接口描述

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

接口地址

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

请求参数

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

返回参数

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

result 说明

参数名	类型	说明
today_active	String	当天激活设备数。
yesterday_active	String	昨天激活设备数。
all_activate	String	累计激活设备数。
near7_day_active	String	近 7 天激活设备数。
last7_day_active	String	上一个近 7 天激活设备数，即从近 7 天到近 14 天期间的数据。
compared_with_yesterday_active	String	当天激活设备数较昨日同比。

请求示例

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
}

错误码

参考错误码。