功能详情

根据accessToken获取当前账号下设备列表。

注意：获取到的accessToken有效期是7天，请在即将过期时重新获取，每个accessToken具备独立的7天生命周期，请勿频繁调用避免占用过多接口调用次数。

请求地址和方法

• 请求地址

https://www.sdzhiot.top/api/v3/rodent/list

• 请求方法

GET

请求参数

字段名	字段类型	字段说明	是否必须
pageNo	Int	分页索引	N（默认为 1）
pageSize	Int	每页数据量	N（默认为 10，不能超过 10）

样例输入

/api/v3/rodent/list?pageNo=1&pageSize=3

返回data字段说明

字段名	字段类型	字段说明
sno	String	鼠兔设备唯一编号
name	String	设备名称
address	String	设备安装地址
position	String	设备经纬度坐标
status	Integer	设备状态（0：离线 1：在线）
latestTime	Date	最新数据上报时间

样例输出

{
    "code": 0,
        "data": {
        "list": [
            {
                "sno": "9A3CCB79C689",
                "name": "鼠兔害智能采集设备",
                "address": "山东省威海市环翠区汪疃镇201省道神山葡萄庄园",
                "position": "[122.022359,37.364453]",
                "status": 1,
                "heartbeat": null,
                "latestTime": "2025-06-09 16:03:04"
            },
            {
                "sno": "12314F904FD4",
                "name": "鼠害入网",
                "address": null,
                "position": null,
                "status": 0,
                "heartbeat": null,
                "latestTime": "2025-05-14 10:02:44"
            }
        ],
            "total": 2
    },
    "msg": "操作成功"
}

返回码

返回码	返回消息	说明
0	操作成功	请求成功
500	服务器错误	服务端异常
10001	参数为空或格式不正确	参数错误
10002	appKey不存在	确认appKey是否正确