调用该接口分页查询发现设备的列表。
路径 | /awss/enrollee/list/get |
版本号 | 1.0.7 |
协议 | HTTP,HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
pageSize | Int | 是 | 10 | 分页大小,取值范围:1~20。 |
pageNum | Int | 是 | 1 | 分页页码,从 1 开始。 |
groupId | String | 否 | 空间的ID。生活物联网平台赋予空间的唯一标识符。 | |
productStatusEnv | String | 否 | dev | 产品状态。dev(表示产品开发中);release(表示产品已发布)。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
totalNum | Int |
获取到设备的总数。 |
|
items | JSON |
设备列表信息。 |
|
gmtCreate | Long |
发现设备的创建时间。 |
|
gmtModified | Long |
发现设备的修改时间。 |
|
regIotId | String |
已配网设备的设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。 |
|
regProductKey | String |
已配网设备所属产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。 |
|
regDeviceName | String |
已配网设备的设备名称。 |
|
regProductName | String |
已配网设备所属产品的名称。 |
|
enrolleeIotId | String |
待配网设备的设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。 |
|
enrolleeProductKey | String |
待配网设备所属产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。 |
|
enrolleeDeviceName | String |
待配网设备的设备名称。 |
|
enrolleeProductName | String |
待配网设备所属产品的名称。 |
|
bssid | String |
路由器BSSID。 |
|
ssid | String |
热点SSID。 |
|
rssi | String |
热点RSSI。 |
|
type | Int |
发现者设备类型,0(表示Device);1(表示Router)。 |
|
status | Int |
配网过程状态,0(表示初始态); 1(表示配网中)。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.7",
"iotToken": "token"
},
"params":{
"pageSize":10,
"pageNum":1,
"groupId": "value2",
"productStatusEnv": "dev"
}
}
正常返回示例
JSON
格式
{
"code": 200,
"data": {
"totalNum":12,
"items":[
{
"gmtCreate":"xxx",
"gmtModified":"xxx",
"regIotId":"xxx",
"regProductKey":"xxx",
"regDeviceName":"xxx",
"enrolleeIotId":"xxx",
"enrolleeProductKey":"xxx",
"enrolleeDeviceName":"xxx",
"bssid":"xxx",
"ssid":"xxx",
"rssi":"xxx",
"type":0,
"status":1
}
]
},
"message": "success"
}
异常返回示例
JSON
格式
{
"code":460,
"message":"paramerror"
}