# 功能详情

根据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 签名错误 参数签名错误