功能详情

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

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

请求地址和方法

• 请求地址

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

• 请求方法

GET

请求参数

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

样例输入

/api/v3/spore/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": "64873868240E",
                "name": "孢子分析仪8561",
                "address": "潍坊市寿光",
                "position": "[118.82,36.86]",
                "status": 0,
                "heartbeat": "2024-11-05 08:03:52",
                "latestTime": "2024-09-25 16:03:39"
            },
            {
                "sno": "4B8FBAC0A01C",
                "name": "/",
                "address": "山东省威海市昌宏工业园",
                "position": "[\"121°11\",\"36°41\"]",
                "status": 0,
                "heartbeat": null,
                "latestTime": "2024-08-16 02:30:29"
            },
            {
                "sno": "7415D1204828",
                "name": "孢子捕捉仪",
                "address": "山东省威海市环翠区怡园街道丹东路46号威海广隆房地产",
                "position": "[null,null]",
                "status": 0,
                "heartbeat": null,
                "latestTime": "2025-02-19 01:59:50"
            }
        ],
        "total": 3
    },
    "msg": "操作成功"
}

返回码

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