HTTP/HTTPS
请求协议
中科图灵开放平台 / 智慧消防设备管理模块 / 设备以及对应的电量列表
设备以及对应的电量列表
接口地址:https://api.iot.ink/api/app.php?s=Equipment.Device_DevicePower_GetlistDevicePower.Api
接口描述: 设备以及对应的电量列表
接口参数
参数名字 | 类型 | 是否必须 | 默认值 | 其他 | 说明 |
---|---|---|---|---|---|
access_token | 字符串 | 可选 | 访问令牌,仅当开启签名验证时需要传递,生成令牌可使用App.Auth.ApplyToken接口 | ||
deptId | 字符串 | 必须 | - | 单位id 示例 | |
isDept | 字符串 | 必须 | - | 0;单位 1:区域 示例 | |
highPower | 字符串 | 必须 | - | 电量上限 示例 | |
lowPower | 字符串 | 必须 | - | 电量下限 示例 | |
apiRequestRaw | 字符串 | 可选 | - | ||
headerInfo | 字符串 | 可选 | - | [] |
返回字段
返回结果 | 类型 | 说明 |
---|---|---|
ret | 整型 | 状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误 |
data | 对象或混合类型 | 业务数据,由各自接口指定,通常为对象 |
data.code | 字符串 | |
data.msg | 字符串 | |
data.data | Array | |
data.data>>total | 字符串 | |
data.data>>list | 数组 | |
data.data>>list>>id | 字符串 | |
data.data>>list>>deviceCode | 字符串 | 设备编码 |
data.data>>list>>deviceId | 字符串 | |
data.data>>list>>powerValue | 字符串 | 电量值 |
data.data>>list>>uploadTime | 字符串 | |
data.data>>list>>createTime | 字符串 | |
data.data>>list>>deptId | 字符串 | |
data.data>>list>>deptName | 字符串 | 单位名称 |
data.data>>list>>isDept | 字符串 | |
data.data>>list>>deptIdList | 字符串 | |
data.data>>list>>highVoltage | 字符串 | |
data.data>>list>>lowVoltage | 字符串 | |
data.data>>list>>deviceTypeName | 字符串 | 设备类型名 |
data.data>>list>>deviceModelName | 字符串 | 设备型号名 |
data.data>>list>>addressDesc | 字符串 | 位置描述 |
data.data>>list>>betweenMonth | 字符串 | 已安装时长 |
data.data>>pageNum | 字符串 | |
data.data>>pageSize | 字符串 | |
data.data>>size | 字符串 | |
data.data>>startRow | 字符串 | |
data.data>>endRow | 字符串 | |
data.data>>pages | 字符串 | |
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 | 字符串 | |
msg | 字符串 | 提示信息,失败时的错误提示 |
在线测试
参数 | 是否必须 | 值 |
---|---|---|
service | 必须 | |
access_token | 可选 | |
deptId | 必须 | |
isDept | 必须 | |
highPower | 必须 | |
lowPower | 必须 | |
apiRequestRaw | 可选 | |
headerInfo | 可选 |
客户端请求示例
成功响应返回示例:
{
"code": 0,
"msg": null,
"data": {
"total": 80,
"list": [
{
"id": null,
"deviceCode": "wxyg894512",
"deviceId": null,
"powerValue": "97.31",
"uploadTime": null,
"createTime": "2022-07-07 16:31:04",
"deptId": 460,
"deptName": "一般单位1",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "无线复合式感温感烟报警器",
"deviceModelName": "TR-19SD01L",
"addressDesc": "学生公寓测试设备",
"betweenMonth": 0
},
{
"id": null,
"deviceCode": "867572058700683",
"deviceId": null,
"powerValue": "1.23",
"uploadTime": null,
"createTime": "2021-11-26 14:15:08",
"deptId": 462,
"deptName": "测试一般单位",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "NB-IOT五合一消火栓",
"deviceModelName": "TR-21FC01N",
"addressDesc": "2021/11/26 300套消火栓测试",
"betweenMonth": 8
},
{
"id": null,
"deviceCode": "861410044929015",
"deviceId": null,
"powerValue": "7870.0",
"uploadTime": null,
"createTime": "2021-10-19 14:41:02",
"deptId": 460,
"deptName": "一般单位1",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "单相电子式电能表",
"deviceModelName": "DDS155",
"addressDesc": "ce",
"betweenMonth": 9
},
{
"id": null,
"deviceCode": "867572058702564",
"deviceId": null,
"powerValue": "1.23",
"uploadTime": null,
"createTime": "2021-11-26 14:15:09",
"deptId": 462,
"deptName": "测试一般单位",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "NB-IOT五合一消火栓",
"deviceModelName": "TR-21FC01N",
"addressDesc": "2021/11/26 300套消火栓测试",
"betweenMonth": 8
},
{
"id": null,
"deviceCode": "868591056824146",
"deviceId": null,
"powerValue": "100.0",
"uploadTime": null,
"createTime": "2022-01-26 11:26:06",
"deptId": 462,
"deptName": "测试一般单位",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "NB-IoT无线复合式感温感烟报警器",
"deviceModelName": "TR-20SD01N",
"addressDesc": "武软03",
"betweenMonth": 6
},
{
"id": null,
"deviceCode": "867572058671785",
"deviceId": null,
"powerValue": "1.22",
"uploadTime": null,
"createTime": "2021-11-22 13:00:20",
"deptId": 462,
"deptName": "测试一般单位",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "NB-IOT五合一消火栓",
"deviceModelName": "TR-21FC01N",
"addressDesc": "测试消火栓",
"betweenMonth": 8
},
{
"id": null,
"deviceCode": "004a7701240467f0",
"deviceId": null,
"powerValue": "1.22",
"uploadTime": null,
"createTime": "2021-10-21 16:30:14",
"deptId": 462,
"deptName": "测试一般单位",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "LoRaWAN五合一消火栓",
"deviceModelName": "TR-21FC01LW",
"addressDesc": "V1.5-360-12h-168h",
"betweenMonth": 9
},
{
"id": null,
"deviceCode": "862657056794773",
"deviceId": null,
"powerValue": "1.23",
"uploadTime": null,
"createTime": "2022-03-17 15:42:32",
"deptId": 1043,
"deptName": "硬件生产线",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "NB-IOT五合一水压",
"deviceModelName": "TR-21SP01N",
"addressDesc": "测试3.17",
"betweenMonth": 4
},
{
"id": null,
"deviceCode": "867572058700741",
"deviceId": null,
"powerValue": "1.23",
"uploadTime": null,
"createTime": "2021-11-26 14:15:07",
"deptId": 462,
"deptName": "测试一般单位",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "NB-IOT五合一消火栓",
"deviceModelName": "TR-21FC01N",
"addressDesc": "2021/11/26 300套消火栓测试",
"betweenMonth": 8
},
{
"id": null,
"deviceCode": "867572058755497",
"deviceId": null,
"powerValue": "100.0",
"uploadTime": null,
"createTime": "2021-11-22 13:00:20",
"deptId": 462,
"deptName": "测试一般单位",
"isDept": null,
"deptIdList": null,
"highVoltage": null,
"lowVoltage": null,
"deviceTypeName": "NB-IOT五合一消火栓",
"deviceModelName": "TR-21FC01N",
"addressDesc": "测试消火栓",
"betweenMonth": 8
}
],
"pageNum": 1,
"pageSize": 10,
"size": 10,
"startRow": 1,
"endRow": 10,
"pages": 8,
"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
}
}
失败响应返回示例:
错误列表
错误状态码 | 错误描述信息 |
---|---|
400 | ret=400,客户端参数错误或非法请求 |
404 | 表示接口服务不存在 |
406 | ret=406,access_token令牌校验不通过 |
407 | ret=407,app_key权限不足,或未知应用 |
408 | ret=408,当前用户禁止使用,或用户未登录 |
409 | ret=409,接口流量不足 |
500 | 表示服务端内部错误 |
本文档生成时间:2024-03-29 10:01:01