如何调用API获取活跃设备的概览信息-阿里云帮助中心

调用该接口获取活跃设备的概览信息。


路径	/living/data/device/activesummary/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天的数据。
params	JSON	params
page	JSON	page
total	Int	total
size	Int	size
to	Int	to
message	String	调用失败时，返回的出错信息。

示例

请求示例

{
	"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
}