查询设备列表

1. 应用场景

第三方平台根据调用接口查询设备列表。

2. 请求链接

URL地址：http://IP:Port/openapi/Device/GetList

3. 请求参数

字段	类型	长度	必填	描述	示例值
companyno	string	32	是	企业编号	e41e0f04d13e4196
timestamp	string	32	是	时间戳字符串	20200701161800123
sign	string	50	是	签名字符串	同社区接口签名一致
data	string		是	参数必须是正确的json字符串格式，并且经过AES加密	详情见参数示例
» pageindex	Int	11	是	当前页数	1
» pagesize	Int	11	是	每页显示数量	20
» deviceno	String	32	否	设备编号
» devicename	String	32	否	设备名称
» ip	String	32	否	设备IP

4. 返回结果

字段	类型	描述	示例值
resultcode	string	结果状态	1成功，0失败
msg	string	结果信息
companyno	string	企业编号	e41e0f04d13e4196
timestamp	string	时间戳字符串	20200701161800123
sign	string	签名字符串	同社区接口签名一致
data	string	参数必须是正确的json字符串格式，并且经过 AES加密	详情见参数示例
» total	Int	总数量
» totalPage	int	总页数
» data	string
»» no	string	设备编号
»» name	string	设备名称
»» ip	string	IP地址
»» area	string	安装位置
»» regionname	string	所属区域（名称）
»» outintype	Int	出入口 0=出口，1=入口
»» isenableattend	Int	是否启用考勤 0=不启用，1=启用
»» onlinestatus	Int	在线状态 0=离线，1-在线

4.1. 返回成功

{
    "resultcode": "1",
    "msg": "查询成功",
    "companyno": "2201140459374",
    "timestamp": "20220330142506052",
    "data": {
        "total": 30,
        "totalPage": 2,
        "data": [
            {
                "no": "220114020314C",
                "name": "张*的设备",
                "ip": "192.168.22.30",
                "area": "4楼门口",
                "regionname": "默认区域",
                "outintype": 0,
                "isenableattend": 1,
                "onlinestatus": "0"
            },
            {
                "no": "230816192844F",
                "name": "230816192844F",
                "ip": "192.168.20.98",
                "area": "",
                "regionname": "默认区域",
                "outintype": 1,
                "isenableattend": 0,
                "onlinestatus": "0"
            }
        ]
    },
    "sign": "7cc62da13e3c91bc8b7a07706d6a5243"
}

4.2. 返回失败

{
    "resultcode": "0",
    "msg": "获取列表失败",
    "companyno": "2201140459374",
    "timestamp": "20220330142506052",
    "data": "",
    "sign": "7cc62da13e3c91bc8b7a07706d6a5243"
}

作者：mry 创建时间：2025-07-21 09:02
最后编辑：mry 更新时间：2025-07-21 15:05