说明

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

接口地址

POST /api/3ph/list?appid={AppID}

请求参数说明

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

Body 示例

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

Body 字段说明

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

回复数据

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "total": 3,
    "page": 1,
    "size": 10,
    "list": [
      {
        "socket_sn": "94A9901BB900",
        "status": true,
        "device_name": "B900",
        "desc": "",
        "connected": false,
        "connected_time": 0,
        "disconnected_time": 0
      },
      {
        "socket_sn": "94A9901BBC28",
        "status": true,
        "device_name": "94A9901BBC28",
        "desc": "",
        "connected": false,
        "connected_time": 1778157844,
        "disconnected_time": 1780655839
      },
      {
        "socket_sn": "94A9901BBDE8",
        "status": true,
        "device_name": "94A9901BBDE8",
        "desc": "",
        "connected": false,
        "connected_time": 1765789248,
        "disconnected_time": 1766042543
      }
    ]
  }
}

回复字段说明

名称 类型 必填 说明
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.socket_sn string 设备序列号
作者：阮德明  创建时间：2026-06-08 14:21
最后编辑：阮德明  更新时间：2026-07-13 09:41