获取设备有效交互数据

更新时间:2023-06-15 05:10:25

本文介绍获取设备有效交互数据的 API。

接口描述

获取指定时间范围内设备有效交互数据。

接口地址

GET: /v1.0/iot-datacenter/app/device/effective/interaction/stat

请求参数

参数名类型参数位置是否必填说明
paramsStringquerytrueJSON

params 说明

参数名类型参数位置是否必填说明
startDayString true开始时间
endDayString true截止时间
productIdString false产品ID
countryString false国家
dimensionString false维度,可选字段如下
  • format_country_name : 国家的中文名称
  • en_country_name : 国家的英文名称

返回参数

参数名类型说明
resultJSONArray

result 说明

参数名类型说明
interactionNumInteger设备有效交互数
enCountryNameString国家的英文名称
dtString日期
formatCountryNameString国家的中文名称

请求示例

GET: /v1.0/iot-datacenter/app/device/effective/interaction/stat?params={"startDay":"20211007" ,"endDay":"20211007","dimension":"en_country_name"}

返回示例

{
    "result": [
        {
            "dt": 20211007,
            "enCountryName": "United States",
            "interactionNum": 0
        },
        {
            "dt": 20211007,
            "enCountryName": "others",
            "interactionNum": 459
        },
        {
            "dt": 20211007,
            "enCountryName": "Germany",
            "interactionNum": 10
        },
        {
            "dt": 20211007,
            "enCountryName": "Japan",
            "interactionNum": 0
        },
        {
            "dt": 20211007,
            "enCountryName": "China",
            "interactionNum": 1167
        }
    ],
    "t": 1633764761266,
    "success": true
}

错误码

参考 错误码