说明

分页查询平台现有的网关列表

接口地址

POST /api/ac/list?appid={AppID}

请求参数说明

名称 类型 必填 说明
appid string Y 管理员给用户创建的应用ID

Body 示例

{
  "socket_sn": "94A9901BB884",
  "status": true,
  "device_name":"",
  "connected":true,
  "version":"1.4.3",
  "page":1,
  "size":10
}

Body 字段说明

名称 类型 必填 说明
socket_sn string N 网关序列号。精确查询
status bool N 网关状态，是否启用 。不传此字段表示全部
device_name string N 网关名称。模糊查询
connected bool N 网关连接状态。不传此字段表示全部
version string N 版本号。。精确查询
page int Y 第几页
size int Y 每页数据数量

回复数据

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "total": 18,
    "page": 1,
    "size": 3,
    "list": [
      {
        "socket_sn": "089272BE5BAA",
        "status": true,
        "device_name": "5BAA",
        "software_ver": "1.4.3",
        "reboot": 49,
        "desc": "",
        "upload_interval": 60,
        "connected": false,
        "connected_time": 1780898825,
        "disconnected_time": 1780899095
      },
      {
        "socket_sn": "089272BB6ED6",
        "status": true,
        "device_name": "广州22电",
        "software_ver": "1.4.3",
        "reboot": 85,
        "desc": "",
        "upload_interval": 60,
        "connected": false,
        "connected_time": 1780898829,
        "disconnected_time": 1780899099
      },
      {
        "socket_sn": "089272BC570A",
        "status": true,
        "device_name": "570A",
        "software_ver": "1.4.3",
        "reboot": 93,
        "desc": "",
        "upload_interval": 60,
        "connected": false,
        "connected_time": 1780882551,
        "disconnected_time": 1780885945
      }
    ]
  }
}

回复字段说明

名称 类型 必填 说明
code int Y 200:成功，其它：异常。参考文档 通用返回值
msg string Y 消息说明
data object
data.total int 总数
data.page int 页数
data.size int 每页数量
data.list object 数据列表
list.device_name string 设备名
list.status bool 状态
list.connected bool 连接状态
list.connected_time int 连接时间
list.disconnected_time int 断开时间
list.desc string 备注
list.upload_interval int 上传间隔
作者：阮德明  创建时间：2026-06-08 10:07
最后编辑：阮德明  更新时间：2026-07-13 09:41