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

中科图灵开放平台 / 智慧消防设备管理模块 / 获取设备的历史运行数据

获取设备的历史运行数据

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

接口描述： 获取设备的历史运行数据

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

接口参数

参数名字类型是否必须默认值其他说明
access_token字符串可选访问令牌，仅当开启签名验证时需要传递，生成令牌可使用App.Auth.ApplyToken接口
deptId字符串必须-单位id 示例
code字符串必须-设备编码 示例
pageNum字符串必须-页号 示例
pageSize字符串必须-每页数量 示例
system字符串必须-所属系统 示例
startDate字符串必须-测点开始记录时间 示例
endDate字符串必须-测点结束记录时间 示例
addressDesc字符串必须-地址描述 示例
status字符串必须-设备状态 -1未启用 0故障 1报警 2正常 4离线 示例
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>>id字符串
data.data>>list>>system字符串
data.data>>list>>systemName字符串系统名称
data.data>>list>>code字符串设备编号
data.data>>list>>mainEngine字符串
data.data>>list>>mainEngineName字符串
data.data>>list>>address字符串
data.data>>list>>loopBack字符串
data.data>>list>>manufacturer字符串
data.data>>list>>manufacturerName字符串
data.data>>list>>deviceType字符串
data.data>>list>>deviceTypeName字符串
data.data>>list>>deviceModel字符串
data.data>>list>>deviceModelName字符串
data.data>>list>>buildId字符串
data.data>>list>>buildName字符串
data.data>>list>>floor字符串
data.data>>list>>addressDesc字符串位置描述
data.data>>list>>model字符串
data.data>>list>>deptId字符串
data.data>>list>>deptName字符串单位名称
data.data>>list>>tenantId字符串
data.data>>list>>createTime字符串上报时间
data.data>>list>>delFlag字符串
data.data>>list>>status字符串设备状态 -1未启用 0故障 1报警 2正常 4离线
data.data>>list>>mark字符串
data.data>>list>>pushScopeId字符串
data.data>>list>>unit字符串测点单位
data.data>>list>>alarmValue字符串测点数据
data.data>>list>>pointName字符串测点名称 最新数据由：测点名称 + 测点数据 + 测点单位组成
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 可选
deptId 必须
code 必须
pageNum 必须
pageSize 必须
system 必须
startDate 必须
endDate 必须
addressDesc 必须
status 必须
apiRequestRaw 可选
headerInfo 可选

客户端请求示例

HTTP通用示例 
成功响应返回示例：
{
    "code": 0,
    "msg": null,
    "data": {
        "pageNum": 1,
        "pageSize": 10,
        "size": 10,
        "startRow": 1,
        "endRow": 10,
        "total": 17388,
        "pages": 1739,
        "list": [
            {
                "id": null,
                "system": "fc_system_dqhz",
                "systemName": "电气火灾",
                "code": "4664567a0001",
                "mainEngine": null,
                "mainEngineName": null,
                "address": null,
                "loopBack": null,
                "manufacturer": null,
                "manufacturerName": null,
                "deviceType": null,
                "deviceTypeName": null,
                "deviceModel": null,
                "deviceModelName": null,
                "buildId": null,
                "buildName": null,
                "floor": null,
                "addressDesc": "位置非常好",
                "model": null,
                "deptId": 14,
                "deptName": "一般单位1",
                "tenantId": null,
                "createTime": "2020-06-19 18:12:58",
                "delFlag": null,
                "status": 2,
                "mark": null,
                "pushScopeId": null,
                "unit": "A",
                "alarmValue": "0",
                "pointName": "A相电流"
            }
        ],
        "prePage": 0,
        "nextPage": 2,
        "isFirstPage": true,
        "isLastPage": false,
        "hasPreviousPage": false,
        "hasNextPage": true,
        "navigatePages": 8,
        "navigatepageNums": [
            1,
            2,
            3,
            4,
            5,
            6,
            7,
            8
        ],
        "navigateFirstPage": 1,
        "navigateLastPage": 8,
        "firstPage": 1,
        "lastPage": 8
    }
}
失败响应返回示例：

错误列表

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

本文档生成时间：2024-05-14 09:49:28