调用该接口分页查询发现设备的列表。

路径 /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"
}