Skip to content

设备列表查询接口

  • 功能:分页查询设备列表。
  • 请求路径:/v1/device/queryDeviceByPage
  • 请求方式:GET
  • 请求参数
名称类型必须描述
snstring设备号
pageNoint第几页,从1开始
pageSizeint每页数量,最大值为100
  • 返回值
名称类型描述
totalint数据总数
pagesint总页数
sizeint每页数量
currentint第几页
recordslist设备数据列表

records返回值:

名称类型描述
snstring节点SN
deviceTypeint设备类型(1小盒子,2工控机,3x86,4手机)
modelTypeint设备架构:1 android,2 arm,3 x86
osNamestring操作系统名称
archNamestringCPU架构
osVersionstring操作系统版本
provincestring省份
citystring城市
ispstring运营商
macAddrstringmac地址
onlineCodeint在线状态
lastPingTimedate最后心跳时间
bizOnlineCodeint业务在线状态
bizOnlineUpdatedAtdate最后心跳时间
bizStatusint调度状态
bizNamestring业务名称
upStreamNatTypeint上游NAT类型
upBandwidthdouble上行带宽
upBandwidthTimedate上行带宽检测时间
createdAtdate上机时间

返回示例:

json
    //正常请求:
    //http code 0
    {
    "code": 0,
    "message": "操作成功!",
    "data": {
        "records": [
            {
              "sn": "XXXXXX",
              "deviceType": 1,
              "modelType": 2,
              "osName": "linux",
              "archName": "arm64",
              "osVersion": "18.04",
              "province": "北京",
              "city": "北京",
              "isp": "联通",
              "macAddr": "00:e0:4c:58:06:f3",
              "onlineCode": 1,
              "lastPingTime": "2025-11-06 12:39:54",
              "bizOnlineCode": 1,
              "bizOnlineUpdatedAt": "2025-11-12 10:20:11",
              "bizStatus": 1,
              "bizName": "W1",
              "upStreamNatType": -1,
              "upBandwidth": 1.0,
              "upBandwidthTime": "2025-11-06 06:23:51",
              "createdAt": "2025-11-05 15:45:00"
            },
            {...}
        ],
        "total": 2,
        "size": 100,
        "current": 1,
        "orders": [],
        "hitCount": false,
        "searchCount": true,
        "pages": 1
    }
    }
json
    //异常请求:
    //http code 4xx/5xx
    {
        "code": 500,
        "message": "签名失败",
        "data": null
    }