Appearance
电表开户接口文档
接口地址
URL地址: http://api2.tqdianbiao.com/Api_v2/ele_security/open_acount
意义
- 开户后开始计量收费
- 新预付费表开始启用时都要进行清零、开户、充值
提示
- 如果选择
系统维护须在系统中选择、设置参数，否则无法开户成功。
接口参数
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 授权码 | auth_code | 是 | String(32) | 系统为使用区域分配的授权码，在后台配置页面获取 |
| 时间戳 | timestamp | 是 | String(10) | 自1970年1月1日（08:00:00 GMT）至当前时间的总秒数 |
| 请求内容 | request_content | 是 | String | 详见request_content字段说明，注意 request_content 是json数组，注意合并请求⭐ |
| 回调地址 | notify_url | 是 | String | 系统处理完查询请求后，通过这个回调地址，把数据推送给请求方 |
| 签名 | sign | 是 | String(32) | 通过签名算法计算得出的签名值，详见签名生成算法 |
请求内容request_content字段说明
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 操作ID | opr_id | 是 | String | 操作ID，长度16-32，请求时自己生成，用于标识一次异步操作任务，须保证唯一性 |
| 采集器号 | cid | 是 | String | 采集器号,4G、NB设备采集器号与表号一致 |
| 表号 | address | 是 | String | 表号（表地址） |
| 超时时间 | time_out | 否 | int | 超时时间 单位秒，任务因通讯异常等情况未执行自动失效的时间 ,默认1年 |
| 是否必须在线 | must_online | 否 | Boolean | 如果传true ,则系统接受任务时设备不在线直接返回失败 ，默认 false |
| 重试次数 | retry_times | 否 | int | 重试次数（0-3） ,默认1次 |
| 操作数据 | params | 是 | json String | 操作所需的数据 |
操作数据params字段说明
| 字段名 | 变量名 | 接入方维护参数 | 系统维护参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|---|
| 初始金额 | money | 必填 | 必填 | String | 100 | |
| 账户Id | account_id | 必填 | 不填 | String | 1 | 建议始终填1 |
| 充值次数 | count | 必填 | 不填 | String | 1 | 开户均填1 |
| 电价 | price | 必填 | 不填 | String | 1 | 单价 范围：0.01-99.9999 (该字段仅单费率表有效) |
| 透支金额 | overdraw | 选填 | 不填 | String | 100 | 透支金额 （电表允许的欠费金额）范围：0-999999 默认：0 |
| 一级报警金额 | display_warning | 选填 | 不填 | String | 20 | 显示报警金额 （剩余金额低于此值报警灯闪烁）范围 0-999999,默认 100 元 |
| 二级报警金额 | pulloff_warning | 选填 | 不填 | String | 10 | 断电报警金额 （剩余金额低于此值断电报警，需用合闸命令）范围 0-999999 ，默认 0 元 |
| 负荷限制功率 | load_limit | 选填 | 不填 | String | 10 | 负荷限制功率 0-99.9999kw 默认 10kw |
| 超负荷恢复延时 | load_delay | 选填 | 不填 | String | 5 | 超过负荷断电后 延迟上电时间 0-99 分钟 ，默认 5 分钟 |
| 电表倍率 | rate | 选填 | 不填 | String | 1 | 电表倍率 ， 默认1 |
| 屏幕轮显时间 | display_time | 选填 | 不填 | String | 10 | 屏幕轮显时间 0-99秒 默认5秒 |
同步返回结果
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 返回状态码 | status | 是 | String | SUCCESS/FAIL，此字段是通信标识 |
| 时间戳 | timestamp | 是 | String(10) | 自1970年1月1日（08:00:00 GMT）至当前时间的总秒数 |
| 回复内容 | response_content | 是 | String | 详见response_content字段说明 |
| 签名 | sign | 是 | String(32) | 通过签名算法计算得出的签名值，详见签名生成算法 |
| 出错原因 | error_msg | 否 | String | 当返回状态码为"FAIL"时，返回信息为错误原因 |
提示
- 当前接口为异步接口，即请求成功后，系统会通过回调地址把结果推送给请求方。 异步回调
同步回复内容response_content字段说明
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 操作ID | opr_id | 是 | String | 操作ID，长度16-32，请求时自己生成，用于标识一次异步操作任务，须保证唯一性 |
| 采集器号 | cid | 是 | String | 采集器号,4G、NB设备采集器号与表号一致 |
| 表号 | address | 是 | String | 表号（表地址） |
| 操作状态 | status | 是 | String | 操作请求结果状态，说明提交的任务成功或者失败 |
| 错误信息 | error_msg | 否 | String | 当操作状态：status值不为“SUCCESS”时，填入具体的出错内容 |
异步返回结果
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 时间戳 | timestamp | 是 | String(10) | 自1970年1月1日（08:00:00 GMT）至当前时间的总秒数 |
| 回复内容 | response_content | 是 | String | 处理结果数据，查询类型不同，包含数据也会有所差异。 |
| 签名 | sign | 是 | String(32) | 通过签名算法计算得出的签名值，详见签名生成算法 |
示例 JSON
json
{
"auth_code": "37577f8fb62a7b14ba55cc6faec5a142",
"timestamp": "1586740681",
"request_content": [
{
"opr_id": "f17c5cc33ca947e18e081fc911ed9c08",
"time_out": 0,
"must_online": true,
"retry_times": 1,
"cid": "19020618114",
"address": "000066660942",
"params": {
"account_id": "123456",
"count": "1",
"money": "100"
}
}
],
"notify_url": "http://115.221.11.179:8022/notify",
"sign": "fee536cf6a37a200d6761df04f5bf368"
}