获取设备累计激活数据趋势

更新时间：2023-06-15 05:10:36

本文介绍获取设备累计激活数据趋势的 API。

接口描述

获取设备累计激活数据趋势，按照国家日期维度来统计。

接口地址

GET: /v1.0/iot-data/devices/activation-total

请求参数

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

params 说明

参数名	类型	是否必填	说明
country	String	false	国家，传入格式是国家英文名
pid	String	false	IoT 平台账号下的 PID，只支持单个 PID
startDay	String	true	开始日期，格式 `YYYYMMDD`，包含开始日期
endDay	String	true	结束日期，格式 `YYYYMMDD`，包含结束日期

返回参数

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

result 说明

参数名	类型	说明
activationNumTotal	Integer	累计设备激活数
activationNumThirtyDay	Integer	近 30 天设备激活数
activationNumToday	Integer	今日设备激活数
activeNumToday	Integer	今日设备活跃数
activeNumSevenDay	Integer	近 7 日设备活跃数
activeNumFourteenDay	Integer	近 14 日设备活跃数
countryName	String	国家名称（中文）
countryNameEn	String	国家名称（英文）
dt	String	日期，`YYYYMMDD` 格式

请求示例

GET: /v1.0/iot-data/devices/activation-total?params={"startDay":"20221206" ,"endDay":"20221212"}

返回示例

{
    "result": [
        {
            "activeNumFourteenDay": 146,
            "activeNumToday": 13,
            "countryNameEn": "China",
            "dt": "20220103",
            "activationNumToday": 13,
            "activeNumSevenDay": 79,
            "activationNumThirtyDay": 260,
            "activationNumTotal": 1863,
            "countryName": "中国"
        },
        {
            "activeNumFourteenDay": 146,
            "activeNumToday": 8,
            "countryNameEn": "China",
            "dt": "20220104",
            "activationNumToday": 8,
            "activeNumSevenDay": 70,
            "activationNumThirtyDay": 263,
            "activationNumTotal": 1871,
            "countryName": "中国"
        },
        {
            "activeNumFourteenDay": 142,
            "activeNumToday": 8,
            "countryNameEn": "China",
            "dt": "20220105",
            "activationNumToday": 7,
            "activeNumSevenDay": 61,
            "activationNumThirtyDay": 254,
            "activationNumTotal": 1878,
            "countryName": "中国"
        },
        {
            "activeNumFourteenDay": 136,
            "activeNumToday": 7,
            "countryNameEn": "China",
            "dt": "20220106",
            "activationNumToday": 7,
            "activeNumSevenDay": 62,
            "activationNumThirtyDay": 261,
            "activationNumTotal": 1885,
            "countryName": "中国"
        },
        {
            "activeNumFourteenDay": 142,
            "activeNumToday": 18,
            "countryNameEn": "China",
            "dt": "20220107",
            "activationNumToday": 18,
            "activeNumSevenDay": 73,
            "activationNumThirtyDay": 265,
            "activationNumTotal": 1903,
            "countryName": "中国"
        },
        {
            "activeNumFourteenDay": 142,
            "activeNumToday": 27,
            "countryNameEn": "China",
            "dt": "20220108",
            "activationNumToday": 11,
            "activeNumSevenDay": 74,
            "activationNumThirtyDay": 269,
            "activationNumTotal": 1914,
            "countryName": "中国"
        },
        {
            "activeNumFourteenDay": 148,
            "activeNumToday": 17,
            "countryNameEn": "China",
            "dt": "20220109",
            "activationNumToday": 17,
            "activeNumSevenDay": 81,
            "activationNumThirtyDay": 273,
            "activationNumTotal": 1931,
            "countryName": "中国"
        },
        {
            "activeNumFourteenDay": 158,
            "activeNumToday": 27,
            "countryNameEn": "China",
            "dt": "20220110",
            "activationNumToday": 11,
            "activeNumSevenDay": 79,
            "activationNumThirtyDay": 283,
            "activationNumTotal": 1942,
            "countryName": "中国"
        }
    ],
    "t": 1641902767155,
    "success": true
}

错误码

参考错误码。

上一篇获取设备激活数据概况

下一篇其他API