調(diào)用該接口獲取活躍設(shè)備的概覽信息。
路徑 | /living/data/device/activesummary/get |
版本號 | 1.0.0 |
協(xié)議 | HTTPS |
請求方法 | POST |
是否需要用戶身份鑒權(quán) | 否 |
超時時間 | 3000 |
請求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
projectId | String | 是 | 項目id | |
productKeys | List | 是 | 產(chǎn)品id列表 |
返回數(shù)據(jù)
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回碼。200表示成功。 |
|
data | JSON |
data |
|
data | JSON |
data |
|
num_14day | Int |
最近14天數(shù)據(jù)。 |
|
num_7day | Int |
最近7天數(shù)據(jù)。 |
|
last_num_14day | Int |
上14天的數(shù)據(jù)。 |
|
rate_14day | String |
比上14天的增長率。 |
|
rate_30day | String |
比上30天的增長率。 |
|
product_key | String |
產(chǎn)品的Key,設(shè)備證書信息之一。創(chuàng)建產(chǎn)品時,生活物聯(lián)網(wǎng)平臺為該產(chǎn)品頒發(fā)的全局唯一標(biāo)識。 |
|
date_time | String |
周期時間。 |
|
num | Int |
當(dāng)天設(shè)備數(shù)據(jù)數(shù)(T+1)。 |
|
rate_7day | String |
比上7天的增長率。 |
|
last_num_7day | Int |
上7天的數(shù)據(jù)。 |
|
num_30day | Int |
最近30天數(shù)據(jù)。 |
|
last_num_30day | Int |
上30天的數(shù)據(jù)。 |
|
params | JSON |
params |
|
page | JSON |
page |
|
total | Int |
total |
|
size | Int |
size |
|
to | Int |
to |
|
message | String |
調(diào)用失敗時,返回的出錯信息。 |
示例
請求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.0"
},
"params":{
"projectId": "value0",
"productKeys": "value1"
}
}
正常返回示例
JSON
格式
{
"id": "4de2c367-c1db-417c-aa15-8c585e595d92",
"code": 200,
"message": null,
"localizedMsg": null,
"data": {
"data": [
{
"num_14day": 6,
"num_7day": 4,
"last_num_14day": 3,
"rate_14day": 1,
"rate_30day": 0.2,
"product_key": "a1ec***A",
"date_time": "2021-06-22 00:00:00",
"num": 0,
"rate_7day": 0.33333333,
"last_num_7day": 3,
"num_30day": 12,
"last_num_30day": 10
}
]
}
}
異常返回示例
JSON
格式
{
"id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
"code": 403,
"message": "request forbidden.",
"localizedMsg": "請求被禁止",
"data": null
}