批量查询设备信息列表
典型场景
已在物联网平台注册的设备，第三方应用若需要根据条件查看多个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。
接口功能
支持第三方应用在物联网平台根据条件查询多个设备的详细信息，包括配置信息、状态信息、服务属性信息等。
接口描述
1 |
public function queryBatchDevicesInfo($qbdiInDTO, $accessToken)
|
参数说明
参数 |
必选/可选 |
位置 |
描述 |
|---|---|---|---|
$qbdiInDTO |
必选 |
query |
见下表PostDeviceCommandInDTO的描述。 |
$accessToken |
必选 |
header |
填写鉴权接口获取的accessToken。 |
参数 |
必选/可选 |
位置 |
描述 |
|---|---|---|---|
$appId |
必选 |
query |
如果是本应用的设备，此参数值可以填写null，否则填写授权应用的appId。 |
$gatewayId |
可选 |
query |
网关ID，用于标识一个网关设备。 |
$nodeType |
可选 |
query |
节点类型，取值：“ENDPOINT”/“GATEWAY”/“UNKNOW”。 |
$deviceType |
可选 |
query |
设备类型。 |
$pageNo |
可选 |
query |
查询的页码。
|
$pageSize |
可选 |
query |
查询每页信息的数量， 缺省值：“1”。 |
$status |
可选 |
query |
查询设备的状态。
|
$startTime |
可选 |
query |
查询注册设备信息时间在startTime之后的记录。时间格式：yyyyMMdd'T'HHmmss'Z'，如 “20151212T121212Z”。 |
$endTime |
可选 |
query |
查询注册设备信息时间在endTime之前的记录。时间格式：yyyyMMdd'T'HHmmss'Z'，如 “20151212T121212Z”。 |
$sort |
可选 |
query |
指定返回记录的排序。
缺省值：“DESC”。 |
$select |
可选 |
query |
指定返回记录，可取值：“imsi”。 |
响应参数
QueryBatchDevicesInfoOutDTO
参数 |
描述 |
|---|---|
$totalCount |
查询的记录数量。 |
$pageNo |
查询的页码。 |
$pageSize |
查询每页信息的数量。 |
$devices |
设备分页列表信息，具体参见QuerySingleDeviceInfoOutDTO结构体。 |
QuerySingleDeviceInfoOutDTO结构体说明：
参数 |
描述 |
|---|---|
$deviceId |
设备ID，用于唯一标识一个设备。 |
$gatewayId |
网关ID，用于标识一个网关设备。 |
$nodeType |
节点类型，取值：ENDPOINT/GATEWAY/UNKNOW。 |
$createTime |
创建设备的时间，时间格式：yyyyMMdd'T'HHmmss'Z'，如“20151212T121212Z”。 |
$lastModifiedTime |
最后修改设备的时间。 |
$deviceInfo |
设备信息，具体参见DeviceInfo结构体。 |
$services |
设备服务列表，具体参见DeviceService结构体。 |
参数 |
描述 |
|---|---|
$nodeId |
标识设备的唯一ID。 |
$name |
设备名称。 |
$description |
设备的描述信息。 |
$manufacturerId |
厂商ID，唯一标识一个厂商。 |
$manufacturerName |
厂商名称。 |
$mac |
设备的MAC地址。 |
$location |
设备的位置信息。 |
$deviceType |
设备类型，大驼峰命名方式，如MultiSensor、ContactSensor、CameraGateway。 |
$model |
设备的型号。 Z-Wave：ProductType + ProductId，16 进制格式 XXXX-XXXX 补0对齐，如：001A-0A12，其他协议的格式待定。 |
$swVersion |
设备的软件版本，。 Z-Wave：主版本号.次版本号，如：1.1。 |
$fwVersion |
设备的固件版本。 |
$hwVersion |
设备的硬件版本。 |
$protocolType |
设备使用的协议类型，当前支持的协议类型：CoAP，huaweiM2M，Z-Wave，ONVIF，WPS，Hue，WiFi，J808，Gateway，ZigBee，LWM2M。 |
$bridgeId |
Bridge标识，表示设备通过哪个Bridge接入物联网平台。 |
$status |
设备的状态，表示设备是否在线，取值范围：“ONLINE”、“OFFLINE”、“INBOX”、“ABNORMAL”。 |
$statusDetail |
设备的状态详情，status条件取值，取值查看$status和$statusDetail。 |
$mute |
表示设备是否处于冻结状态，即设备上报数据时，平台是否会管理和保存。
|
$supportedSecurity |
表示设备是否支持安全模式。
|
$isSecurity |
表示设备当前是否启用安全模式。
|
$signalStrength |
设备的信号强度。 |
$sigVersion |
设备的sig版本。 |
$serialNumber |
设备的序列号。 |
$batteryLevel |
设备的电池电量。 |
$status |
$statusDetail |
|---|---|
OFFLINE |
NONE CONFIGURATION_PENDING |
ONLINE |
NONE COMMUNICATION_ERROR CONFIGURATION_ERROR BRIDGE_OFFLINE FIRMWARE_UPDATING DUTY_CYCLE NOT_ACTIVE |
说明：
设备向物联网平台上报设备状态时需要status、statusDetail成对上报。statusDetail建议仅用作显示，不建议用于逻辑判断。
参数 |
描述 |
|---|---|
$serviceId |
设备的服务标识。 |
$serviceType |
设备的服务类型。 |
$serviceInfo |
设备的服务信息，具体参见ServiceInfo结构体。 |
$data |
属性值对（Attribute-value pair）。 |
$eventTime |
时间格式：yyyyMMdd'T'HHmmss'Z'，如“20151212T121212Z”。 |
参数 |
描述 |
|---|---|
$muteCmds |
屏蔽的设备控制命令列表。 |
错误码
Http状态码 |
错误码 |
错误描述 |
说明 |
|---|---|---|---|
400 |
100216 |
The application input is invalid. |
应用输入无效。 处理建议：请参考请求参数说明检查接口请求中的参数是否有误。 |
400 |
100218 |
The gatewayId and pageNo can't be both null. |
网关ID和pageNo不能同时为空。 处理建议：请检查请求参数中gatewayId或pageNo是否填写。 |
400 |
100405 |
The request parameter is invalid. |
请求参数不合法。 处理建议：请参考请求参数说明检查接口请求中的参数是否有误。 |
403 |
100203 |
The application is not existed. |
应用不存在。 处理建议：
|
403 |
100217 |
The application hasn't been authorized. |
应用未被授权。 处理建议：若非应用授权场景，请确认请求参数中的appId为空。 |
403 |
1010009 |
app throttle exceed. |
应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 |
403 |
1010005 |
App_key or access_token is invalid. |
错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。 |
500 |
100203 |
The application is not existed. |
应用不存在。 处理建议：
|
500 |
50252 |
Internal server error. |
服务器运行内部错误。 处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。 |
