批量查询设备信息

典型场景

已在物联网平台注册的设备，应用服务器若需要根据条件查看多个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。

接口功能

支持应用服务器在物联网平台根据条件查询多个设备的详细信息，包括配置信息、状态信息、服务属性信息等。

接口原型

请求方法	GET
请求地址	https://server:port/iocm/app/dm/v1.4.0/devices?appId={appId}&deviceType={deviceType}&endTime={endTime}&gatewayId={gatewayId}&location={location}&name={name}&nodeType={nodeType}&pageNo={pageNo}&pageSize={pageSize}&select={select}&sort={sort}&startTime={startTime}&status={status}
传输协议	HTTPS

请求参数

参数	必选/可选	类型	位置	描述
app_key	必选	String	header	访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。
Authorization	必选	String	header	访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。
appId	可选	String	query	访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。此处填写授权应用的appId。
gatewayId	可选	String	query	网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。 “gatewayId”与“pageNo”不能同时为空。
nodeType	可选	String	query	节点类型，取值：ENDPOINT/GATEWAY/UNKNOW。
deviceType	可选	String	query	设备类型。
location	可选	String	query	设备位置信息。
name	可选	String	query	设备名称。
pageNo	可选	Integer	query	分页查询时指定要查询的页码信息，默认值为0，取值范围为大于等于0的整数，值为0时，查询第一页。 “gatewayId”与“pageNo”不能同时为空。
pageSize	可选	Integer	query	分页查询时每页显示的记录数，查询结果根据pageSize进行分页，默认值为25，取值范围为1-250的整数。
status	可选	String	query	设备的状态，表示设备是否在线，取值范围：ONLINE、OFFLINE、INACTIVE、ABNORMAL。设备首次接入平台之前，设备的状态为INACTIVE。若设备超过25（默认值）小时未向平台上报数据或发送消息，则设备状态为ABNORMAL（默认值）；若设备超过49小时未向平台上报数据或发送消息，则设备状态为OFFLINE。
startTime	可选	String	query	查询注册设备信息时间在startTime之后的记录。时间格式：yyyyMMdd'T'HHmmss'Z'，如 20151212T121212Z。
endTime	可选	String	query	查询注册设备信息时间在endTime之前的记录。时间格式：yyyyMMdd'T'HHmmss'Z'，如 20151212T121212Z。
sort	可选	String	query	指定返回记录的排序。 ASC：按注册设备的时间升序排列 DESC：按注册设备的时间降序排列缺省值：DESC。
select	可选	String	query	指定返回记录，可取值：imsi。

响应参数

Status Code: 200 OK

参数	类型	描述
totalCount	Long	查询的记录数量。
pageNo	Long	查询的页码。
pageSize	Long	查询每页信息的数量。
devices	List<QueryDeviceDTO4Cloud2NA>	设备分页列表信息。

QueryDeviceDTO4Cloud2NA：

参数	类型	描述
deviceId	String(256)	设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。
gatewayId	String(256)	网关ID，用于标识一个网关设备。当设备是直连设备时，gatewayId与设备的deviceId一致。当设备是非直连设备时，gatewayId为设备所关联的直连设备（即网关）的deviceId。
nodeType	Enum	节点类型，取值：ENDPOINT/GATEWAY/UNKNOW。
createTime	String(256)	创建设备的时间，时间格式：yyyyMMdd'T'HHmmss'Z'，如20151212T121212Z。
lastModifiedTime	String(256)	最后修改设备的时间。
deviceInfo	DeviceInfoQueryDTO	设备信息。
services	List<DeviceService>	设备服务列表。
alarmInfo	AlarmInfoDTO	设备告警信息。

DeviceInfoQueryDTO：

参数	类型	描述
nodeId	String(256)	设备唯一标识码。
name	String(256)	设备名称。
description	String(2048)	设备的描述信息。
manufacturerId	String(256)	厂商ID，唯一标识一个厂商。
manufacturerName	String(256)	厂商名称。
mac	String(256)	设备的MAC地址。
location	String(2048)	设备的位置信息。
deviceType	String(256)	设备类型，大驼峰命名方式，如MultiSensor、ContactSensor、CameraGateway。
model	String(256)	设备的型号。
swVersion	String(256)	设备的软件版本。
fwVersion	String(256)	设备的固件版本。
hwVersion	String(256)	设备的硬件版本。
imsi	String	NB-IoT终端的IMSI。
protocolType	String(256)	设备使用的协议类型。
radiusIp	String	Radius地址。
bridgeId	String(256)	Bridge标识，表示设备通过哪个Bridge接入物联网平台。
status	String	设备的状态，表示设备是否在线，取值范围：ONLINE、OFFLINE、INACTIVE、ABNORMAL。设备首次接入平台之前，设备的状态为INACTIVE。若设备超过25（默认值）小时未向平台上报数据或发送消息，则设备状态为ABNORMAL（默认值）；若设备超过49小时未向平台上报数据或发送消息，则设备状态为OFFLINE。
statusDetail	String(256)	设备的状态详情，跟status取值对应。 status为ONLINE时，取值范围为NONE（无），CONFIGURATION_PENDING（配置待下发），UE_REACHABILITY（设备可达），AVAILABILITY_AFTER_DDN_FAILURE（寻呼失败后设备重新可达）。 status为OFFLINE时，取值范围为NONE（无），COMMUNICATION_ERROR（通信故障），CONFIGURATION_ERROR（配置错误），BRIDGE_OFFLINE（Bridge离线），FIRMWARE_UPDATING（固件升级中），DUTY_CYCLE，NOT_ACTIVE（未激活），LOSS_OF_CONNECTIVITY（连接断开），TIME_OUT（超时）。 status为INACTIVE时，取值范围为NONE（无），NOT_ACTIVE（未激活）。
mute	String	表示设备是否处于冻结状态，即设备上报数据时，平台是否会管理和保存。 TRUE：冻结状态 FALSE：非冻结状态
supportedSecurity	String	表示设备是否支持安全模式。 TRUE：支持安全模式 FALSE：不支持安全模式
isSecurity	String	表示设备当前是否启用安全模式。 TRUE：启用 FALSE：未启用
signalStrength	String(256)	设备的信号强度。
sigVersion	String(256)	设备的sig版本。
serialNumber	String(256)	设备的序列号。
batteryLevel	String(256)	设备的电池电量。

说明：

设备向物联网平台上报设备状态时需要status、statusDetail成对上报。statusDetail建议仅用作显示，不建议用于逻辑判断。

DeviceService：

参数	类型	描述
serviceId	String(256)	设备的服务标识。
serviceType	String(256)	设备的服务类型。
serviceInfo	ServiceInfo	设备的服务信息。
data	ObjectNode(2097152)	属性值对（Attribute-value pair）。
eventTime	String(256)	时间格式：yyyyMMdd'T'HHmmss'Z'，如20151212T121212Z。

ServiceInfo：

参数	类型	描述
muteCmds	List<String>	屏蔽的设备控制命令列表

AlarmInfoDTO：

参数	类型	描述
alarmSeverity	String	告警级别。
alarmStatus	Boolean	告警状态。
alarmTime	String	告警上报时间。

请求示例

Method: GET
request:
https://server:port/iocm/app/dm/v1.4.0/devices?gatewayId={gatewayId}&select=imsi
Header:
app_key: ******
Authorization: Bearer *****
Content-Type: application/json

响应示例

response:
Status Code: 200 OK
Content-Type: application/json
Body:
{
    "totalCount":"****",
    "pageNo":"*****",
    "pageSize":"*****",
    "devices":[
        {
            "deviceId":"xxxxx",
            "gatewayId":"xxxxx",
            "nodeType":"xxxxx",
            "deviceInfo":{
                "nodeId": "123456",
                "name":"Sensor_12",
                "manufacturerName":"wulian",
                "deviceType":"gateway",
                "model":"90",
                "mac":"C7EA1904004B1204",
                "swVersion":"th",
                "fwVersion":"seu",
                "hwVersion":"sru",
                "protocolType":"zigbee",
                "description":"smockdetector",
                "imsi":"xxxxx"
            },
            "services":[
                {
                    "serviceType":"air_conditioner",
                    "serviceId":"1",
                    "data":{
                        "battery_low":"1"
                    }
                },
                {
                    "serviceType":"air_conditioner",
                    "serviceId":"jkh",
                    "data":{
                        "battery_low":"jhj"
                    }
                }
            ]
        },
        {
            "deviceId":"xxxxx",
            "gatewayId":"xxxxx",
            "nodeType":"xxxxx",
            "deviceInfo":{
                "nodeId": "223456",
                "name":"Sensor_12",
                "manufacturerName":"wulian",
                "type":"90",
                "model":" 90",
                "mac":"C7EA1904004B1204",
                "swVersion":"…",
                "fwVersion":"…",
                "hwVersion":"…",
                "protocolType":"zigbee",
                "description":"smockdetector",
                "imsi":"xxxxx"
            },
            "services":[
                {
                    "serviceType":"air_conditioner",
                    "serviceId":"1",
                    "data":{
                        "battery_low":"1"
                    }
                },
                {
                    "serviceType":"air_conditioner",
                    "serviceId":"1",
                    "data":{
                        "battery_low":"1"
                    }
                }
            ]
        }
    ]
}

错误码

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.	应用不存在。处理建议：请检查HTTP请求头域中携带的appId是否有误。请检查请求路径（url）中传入的appId是否有误。
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.	应用不存在。处理建议：请检查HTTP请求头域中携带的appId是否有误。请检查请求路径（url）中传入的appId是否有误。
500	50252	Internal server error.	服务器运行内部错误。处理建议：物联网平台内部错误，请联系物联网平台维护人员处理。

父主题： 数据采集

上一篇：查询单个设备信息

下一篇：查询设备历史数据

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消