# 功能详情
根据accessToken获取当前账号下设备列表。
注意:获取到的accessToken有效期是7天,请在即将过期时重新获取,每个accessToken具备独立的7天生命周期,请勿频繁调用避免占用过多接口调用次数。
# 请求地址和方法
- 请求地址
https://www.sdzhiot.top/api/v1/pestStation/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": "淮安虫情",
"address": "江苏淮安河下古镇",
"position": "[119.13946,33.533981]",
"status": 1,
"heartbeat": "2021-08-25 12:13:30",
"latestTime": "2021-08-25 05:00:00",
},
{
"id": 69,
"sno": "171CB7401321",
"name": "邯郸虫情设备",
"address": "河北邯郸涉县",
"position": "[113.714832,36.618737]",
"status": 1,
"heartbeat": "2021-08-25 12:02:10",
"latestTime": "2021-08-25 06:00:12",
}
]
}
# 返回码
返回码 | 返回消息 | 说明 |
---|---|---|
200 | 操作成功 | 请求成功 |
500 | 服务器错误 | 服务端异常 |
10001 | 参数为空或格式不正确 | 参数错误 |
10002 | appKey不存在 | 确认appKey是否正确 |
10004 | 签名错误 | 参数签名错误 |