首页 OpenAPI 开放平台 文档 动态 商城
语言
简体中文 English
   

中科图灵开放平台 / 智慧消防监测概览模块 / 实时监测(消防系统)-查询设备列表分页 （九小场所共用）

实时监测(消防系统)-查询设备列表分页 （九小场所共用）

接口地址：https://api.iot.ink/api/app.php?s=Monitor.Device_FcSystemMonitor_GetgetDevicePage.Api

接口描述： 实时监测(消防系统)-查询设备列表分页 （九小场所共用）

HTTP/HTTPS
请求协议
GET
请求方式
UTF-8
编码格式
JSON
返回格式
v1.0
版本号

接口参数

参数名字类型是否必须默认值其他说明
access_token字符串可选访问令牌，仅当开启签名验证时需要传递，生成令牌可使用App.Auth.ApplyToken接口
systemCode字符串必须-消防系统code，八大系统code 示例fc_system_dqhz
deptId字符串必须-单位id 示例14
status字符串必须-设备状态 0故障 1报警 2正常 4离线 -1未启用 示例2
deviceCode字符串必须-设备code 示例
apiRequestRaw字符串可选-
headerInfo字符串可选-[]

返回字段

返回结果类型说明
ret整型状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务器错误
data对象或混合类型业务数据，由各自接口指定，通常为对象
data.code字符串
data.msg字符串
data.dataArray
data.data>>pageNum字符串
data.data>>pageSize字符串
data.data>>size字符串
data.data>>startRow字符串
data.data>>endRow字符串
data.data>>total字符串
data.data>>pages字符串
data.data>>list数组
data.data>>list>>deviceId字符串设备id
data.data>>list>>deviceCode字符串设备code
data.data>>list>>deptId字符串单位id
data.data>>list>>deptName字符串单位名称
data.data>>list>>systemCode字符串所属系统code
data.data>>list>>systemName字符串所属系统名称
data.data>>list>>status字符串设备状态
data.data>>list>>statusName字符串设备状态名称
data.data>>list>>manufacturerId字符串厂商id
data.data>>list>>manufacturerName字符串厂商名称
data.data>>list>>deviceTypeId字符串设备类型id
data.data>>list>>deviceTypeName字符串设备类型名称
data.data>>list>>deviceModelId字符串设备型号id
data.data>>list>>deviceModelName字符串设备型号名称
data.data>>list>>addressDesc字符串位置描述
data.data>>list>>floor字符串楼层
data.data>>list>>buildId字符串所属建筑id
data.data>>list>>buildName字符串所属建筑名称
data.data>>prePage字符串
data.data>>nextPage字符串
data.data>>isFirstPage字符串
data.data>>isLastPage字符串
data.data>>hasPreviousPage字符串
data.data>>hasNextPage字符串
data.data>>navigatePages字符串
data.data>>navigatepageNums数组
data.data>>navigateFirstPage字符串
data.data>>navigateLastPage字符串
data.data>>firstPage字符串
data.data>>lastPage字符串
msg字符串提示信息，失败时的错误提示

在线测试   

参数是否必须值
service 必须
access_token 可选
systemCode 必须
deptId 必须
status 必须
deviceCode 必须
apiRequestRaw 可选
headerInfo 可选

客户端请求示例

HTTP通用示例 
成功响应返回示例：
{
    "code": 0,
    "msg": null,
    "data": {
        "pageNum": 1,
        "pageSize": 10,
        "size": 10,
        "startRow": 1,
        "endRow": 10,
        "total": 11,
        "pages": 2,
        "list": [
            {
                "deviceId": 1,
                "deviceCode": "xx00001",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": 4,
                "statusName": "离线",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "楼道",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 3,
                "deviceCode": "4664567a0001",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": 0,
                "statusName": "故障",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "位置非常好",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 4,
                "deviceCode": "4664567a0002",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": 2,
                "statusName": "正常",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "位置非常好",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 5,
                "deviceCode": "4664567a0003",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": 2,
                "statusName": "正常",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "位置非常好",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 6,
                "deviceCode": "4664567a0004",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": 2,
                "statusName": "正常",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "位置非常好",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 7,
                "deviceCode": "4664567a0005",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": 2,
                "statusName": "正常",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "位置非常好",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 8,
                "deviceCode": "4664567a0006",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": 2,
                "statusName": "正常",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "位置非常好",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 9,
                "deviceCode": "4664567a0007",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": -1,
                "statusName": "未启用",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "位置非常好",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 12,
                "deviceCode": "4664567a0010",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": -1,
                "statusName": "未启用",
                "manufacturerId": null,
                "manufacturerName": "厂商1",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 1,
                "deviceModelName": "TR-111",
                "addressDesc": "位置非常好",
                "floor": 2,
                "buildId": 1,
                "buildName": "金sssB5栋"
            },
            {
                "deviceId": 14,
                "deviceCode": "4664567a0012",
                "deptId": 14,
                "deptName": "一般单位1",
                "systemCode": "fc_system_dqhz",
                "systemName": "电气火灾",
                "status": 4,
                "statusName": "离线",
                "manufacturerId": null,
                "manufacturerName": "中科图灵",
                "deviceTypeId": 1,
                "deviceTypeName": "电气火灾传感器",
                "deviceModelId": 7,
                "deviceModelName": "TR-18RKU20",
                "addressDesc": "7喽餐厅",
                "floor": 1,
                "buildId": 2,
                "buildName": "金融港B6栋"
            }
        ],
        "prePage": 0,
        "nextPage": 2,
        "isFirstPage": true,
        "isLastPage": false,
        "hasPreviousPage": false,
        "hasNextPage": true,
        "navigatePages": 8,
        "navigatepageNums": [
            1,
            2
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 2,
        "firstPage": 1,
        "lastPage": 2
    }
}
失败响应返回示例：

错误列表

错误状态码错误描述信息
400ret=400，客户端参数错误或非法请求
404表示接口服务不存在
406ret=406，access_token令牌校验不通过
407ret=407，app_key权限不足，或未知应用
408ret=408，当前用户禁止使用，或用户未登录
409ret=409，接口流量不足
500表示服务端内部错误

本文档生成时间：2024-04-19 02:20:40