調用該接口獲取活躍設備的詳細信息。
路徑 | /living/data/device/activedetail/get |
版本號 | 1.0.0 |
協議 | HTTPS |
請求方法 | POST |
是否需要用戶身份鑒權 | 否 |
超時時間 | 3000 |
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
projectId | String | 是 | 1234 | 項目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天的數據。 |
示例
請求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.0"
},
"params":{
"projectId": "1234",
"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": "a10M9yxKZMC",
"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
}