调用该接口获取设备激活数据概览的信息。
路径 | /living/data/device/activatesummary/get |
版本号 | 1.0.0 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 否 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
projectId | String | 是 | 项目ID | |
productKeys | List | 是 | 产品ID列表 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回码。200表示成功。 |
|
data | JSON |
data |
|
data | JSON |
data |
|
num_14day | Int |
最近14天数据。 |
|
num_7day | Int |
最近7天数据。 |
|
last_num_14day | Int |
上14天的数据。 |
|
rate_14day | String |
比上14天的增长率。 |
|
rate_30day | String |
比上30天的增长率。 |
|
product_key | String |
产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。 |
|
date_time | String |
周期时间。 |
|
num | Int |
当天设备数据数(T+1)。 |
|
rate_7day | String |
比上7天的增长率。 |
|
last_num_7day | Int |
上7天的数据。 |
|
num_30day | Int |
最近30天数据。 |
|
last_num_30day | Int |
上30天的数据。 |
|
message | String |
调用失败时,返回的出错信息。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.0"
},
"params":{
"projectId": "value0",
"productKeys": "value1"
}
}
正常返回示例
JSON
格式
{
"code": 200,
"data": {
"data": [
{
"num_14day": 31,
"num_7day": 25,
"last_num_14day": 34,
"rate_14day": "-0.08823529",
"rate_30day": "0.03030303",
"product_key": "a10****KZMC",
"date_time": "2021-07-04 00:00:00",
"num": 2,
"rate_7day": "-0.16666667",
"last_num_7day": 30,
"num_30day": 34,
"last_num_30day": 33
}
]
},
"id": "6dc1827a45fd492783f9f6980da6d1c8"
}
异常返回示例
JSON
格式
{
"id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
"code": 403,
"message": "request forbidden.",
"localizedMsg": "请求被禁止",
"data": null
}