# 功能详情

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

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

# 请求地址和方法

  • 请求地址

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

  • 请求方法

GET

# 请求参数

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

# 样例输入

/api/v3/water/list?pageNo=1&pageSize=10

# 返回data字段说明

字段名 字段类型 字段说明
deviceId Long 设备id
sno String 设备唯一编号
name String 设备名称
status Integer 0:离线 1:在线

# 样例输出

{
    "msg": "操作成功",
    "code": 0, 
    "data":{
        "list":[
            {
                "deviceId": 3412,
                "sno": "ysiot16011004008",
                "name": "混液式水肥机",
                "status": 0
            },
            {
                "deviceId": 3413,
                "sno": "ysiot16011004009",
                "name": "旁通式水肥机",
                "status": 1
            }
        ],
        "total": 2
    }
}

# 返回码

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