Appearance
查询设备列表和当前状态
接口地址
plaintext
http://api1.tqdianbiao.com/Api/Meter?auth=123456789接口调用频率
plaintext
建议调用频率小于 20次/小时TIP
提示
- 通过接口操作合闸/开阀、拉闸/关阀，系统不维护继电器/阀门状态，请自行维护。 -- 接口操作系统有给回调。
- 余额大于零，一定是合闸/开阀状态， 操作拉闸/关阀，回调通知成功一定是拉闸/关阀状态。
单条数据样例
json
{
"id": "1330607", //设备档案ID
"cid": "116611", //采集器档案ID
"collectorid": "202003230000", //采集器号
"address": "202003230000", //表地址/表号
"priceid": "0", //关联价格档案ID (priceid和param_id 每块表只会用其中一种)
"param_id": "2", //参数ID
"account_id": "24", //户号
"label_id": "0", //标签ID
"count": "6", // 购买次数/充值次数
"device_type": "0", //设备类型 0 表示电表 ， 1 表示水表
"relay_state": "1",
"battery_state": "0",
"description": "" //备注
}数据字段说明
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 设备档案ID | id | 是 | String | 设备档案ID ⭐ |
| 采集器档案ID | cid | 是 | String | 采集器档案ID ⭐ |
| 采集器号 | collectorid | 是 | String | 4G、NB设备采集器号与表号一致。 ⭐ |
| 表地址 | address | 是 | String | 表地址 ⭐ |
| 档案ID | priceid | 是 | String | 关联价格档案ID priceid和param_id 每块表只会用其中一种 |
| 参数ID | param_id | 是 | String | 关联参数档案ID priceid和param_id 每块表只会用其中一种 |
| 倍率 | rate | 是 | int | 互感表有效，互感表 的实际用量是 倍率 * 表显用量 ,接口所有和倍率相关的数据都是没有计算过倍率的的由接入方自行计算 ，其他接口文档会有备注 |
| 户号 | account_id | 是 | String | 户号 |
| 标签ID | label_id | 是 | String | 标签ID |
| 购买次数/充值次数 | count | 是 | String | 购买次数/充值次数 |
| 设备类型 | device_type | 是 | String | 设备类型 0 表示电表 ， 1 表示水表 |
| 设备型号 | type | 是 | String | 设备型号 对应设备在系统中的表类型，见 设备型号 |
| 继电器/阀门状态 | relay_state | 是 | String | 继电器状态 1 表示合闸/开阀， 0 表示拉闸/关阀，其他，表示未知状态或异常 |
| 电池状态 | battery_state | 是 | String | 水表电池状态 0 正常 ， 1 电池低电压,其他 电池低电压 |
| 备注 | description | 是 | String | 备注 可通过接口添加时备注 |
type 字段解析(一般不需要)
type字段 说明：
第一位： 设备类型 0:电表 1:水表
第三位： 电表接线方式 0 单相表，1,2 三相表
第四位： 电表费率类型 0 单费率， 1多费率
示例:
13300 根据第一位数字0表示水表
012151 表示三相多费率电表
注意
WARNING
- 非4g 电表需设置定时抄表，抄继电器状态或者，运行状态字，继电器状态才会更新。
- 水表阀门状态也需要定时抄水表数据，才能更新。