功能详情

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

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

请求地址和方法

• 请求地址

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

• 请求方法

GET

参数说明

• 请求头

Content-Type:application/json;charset=UTF-8

• 请求参数

字段名	字段类型	字段说明	是否必须
token	String	accessToken	Y
pageNum	Integer	起始页数，默认为1	N
pageSize	Integer	每页条数，默认为10	N

样例输入

{
    "system": {
        "appKey": "4a092226ddde4b2b9a8ba63e085ecd85",
        "sign": "b006136a59cecfe5a6d7dc26e5a8d8de",
        "time": 1603352833
    },
    "params": {
        "pageNum": 1,
        "pageSize": 10,
        "token": "zh.ade5042ee589d93d189a826f5fa81d30.8f38b2ccc0f58ac59e44f47c33604899"
    }
}

返回data字段说明

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

样例输出

{
    "msg": "操作成功",
    "total": 2,
    "code": 200,
    "rows": [
        {
            "id": 68,
            "sno": "171CB7400944",
            "name": "陕西孢子1",
            "address": "陕西铜川市宜君县",
            "position": "[109.115009,35.394673]",
            "status": 1,
            "heartbeat": "2023-09-17 12:00:05",
            "latestTime": "2021-09-18 11:30:30",
        },
        {
            "id": 69,
            "sno": "171CB7401321",
            "name": "陕西孢子2",
            "address": "陕西铜川市宜君县",
            "position": "[109.117213,35.393361]",
            "status": 1,
            "heartbeat": "2021-09-17 12:01:30",
            "latestTime": "2021-09-18 12:00:01",
        }
    ]
}

返回码

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