# 功能详情
根据accessToken获取当前账号下控制设备。
注意:获取到的accessToken有效期是7天,请在即将过期时重新获取,每个accessToken具备独立的7天生命周期,请勿频繁调用避免占用过多接口调用次数。
# 请求地址和方法
- 请求地址
https://www.sdzhiot.top/api/v1/control/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字段说明
字段名 | 字段类型 | 字段说明 |
---|---|---|
deviceId | Long | 设备id |
sno | String | 设备唯一编号 |
name | String | 设备名称 |
# 样例输出
{
"msg": "操作成功",
"total": 2,
"code": 200,
"pageSize": 10,
"pageNum": 1,
"rows": [
{
"deviceId": 6974,
"sno": "0948F90EEDC6",
"name": "烟草控制柜(1号)1676",
"status": 0
},
{
"deviceId": 6975,
"sno": "A8DD819F7B5E",
"name": "烟草控制柜(2号)1677",
"status": 0
}
]
}
# 返回码
返回码 | 返回消息 | 说明 |
---|---|---|
200 | 操作成功 | 请求成功 |
500 | 服务器错误 | 服务端异常 |
10001 | 参数为空或格式不正确 | 参数错误 |
10002 | appKey不存在 | 确认appKey是否正确 |
10004 | 签名错误 | 参数签名错误 |