调用该接口根据过滤规则,从客户端通过本地通讯发现的本地设备列表中过滤出还未被用户绑定的设备信息。

路径 /awss/enrollee/product/filter
版本号 1.0.9
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 15000

请求参数

名称 类型 是否必选 示例值 描述
iotDevices List [{"productKey":"pk1","deviceName":"dn1"},{"productKey":"pk2","deviceName":"dn2"}] 本地发现的设备信息列表。
productKey String a1h****aDXE 产品的Key,设备证书信息之一。创建产品时,生活物联网平台为该产品颁发的全局唯一标识。
deviceName String 23FS90G****GJWWEGR 设备的名称,设备证书信息之一。在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。
reset Boolean reset标记。true(不过滤已经绑定的该设备);false(过滤已经绑定的该设备)。
productId String 1234 表示产品的全球唯一id,类比于productKey蓝牙配网的时候可以传此参数过滤。
productStatusEnv String release 产品状态。dev(表示产品开发中);release(表示产品已发布)。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

message String

调用失败时,返回的出错信息。

localizedMsg String

本地语言的错误信息。

data JSON

返回的产品信息。

productKey String

产品的Key。

deviceName String

设备名称。

token String

设备上传的生活物联网平台Token。

productName String

产品名称。

netType Int

产品入网类型:0(表示LoRa);3(表示WiFi);4(表示ZigBee);5(表示Bluetooth);6(表示蜂窝网);7(表示以太网);8(表示其他入网方式)。

nodeType Int

节点类型。0(表示设备);1(表示网关)。

categoryKey String

产品所属品类的品类标识符。

categoryName String

产品所属品类的名称。

categoryId Long

产品归属品类的ID。

image String

产品图标URL。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.9",
		"iotToken": "token"
	},
	"params":{
		"iotDevices":[
			{
				"productKey": "pk1",
				"deviceName": "dn1"
			},
			{
				"productKey": "pk2",
				"deviceName": "dn2"
			}
		],
		"productStatusEnv": "release"
	}
}

正常返回示例

JSON格式

{
    "code": 200,
    "data":[{
                "productKey":"a1v12d****",
                "deviceName":"xxxxxx",
                "netType":3,
                "nodeType":0,
                "categoryKey":"xxx",
                "categoryName":"xxx",
                "categoryId":14
            }
    ],
    "message": "success"
}

异常返回示例

JSON格式

{
    "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
    "code": 403,
    "message": "request forbidden.",
    "localizedMsg": "请求被禁止",
    "data": null
}