api&doc

接口

接口分类定义

• 同步接口

  • 设备数据
  • 设备历史抄表数据 -...

• 设备管理接口

• 异步接口

  • 充值
  • 控制
  • 抄表 -...

ping

WARNING

接口禁止ping

充值时常见问题

• 异常提示：85:充值次数错误 充值次数错了 检查前后充值记录 确认按照要求传 次数参数
• 异常提示：84:客户编号不匹配 户号错误 获取系统设置的户号
• 异常提示：82:密码错误 户号错误 （未开户直接充值可能会引发此错误）
• 充值金额不匹配 -- 充值次数重复了，相同充值参数（次数）第二次充值是查询的效果
• 充值后金额没有变动 -- 充值成功，但金额没有变动，充值次数和金额和上次充值参数一致 是查询的效果查询出上次充值成功。
• 水价未生效, 调用错了接口，参考水价接口

异常排查思路

1. 检查出现异常时前面的几个充值记录，一般都是参数传错了，或者是有异常未及时处理，

充值时业务设计建议

• 同一个设备要限制连续充值，在上次充值回调（或得到充值结果）之前，不要进行下次充值。

定时抄表/上报

• 后台有定时任务抄表功能，如果后台没有设置，请手动设置。
• 接口的历史抄表数据，依赖于后台定时任务。
• 参数都对，没有数据？
  • 确认系统中有没有数据，检查是否设置好了定时抄表，或许是系统没有抄表导致没有数据产生。
  • 检查参数，检查过了？ 请再检查一遍（90%的情况接口传参错误）。
• 历史抄表数据不对? ---- 检查接口参数、是否有删除表、检查下接口参数 抄表数据
• 数据有延迟？ ----- 一般是信号不好导致、属于正常情况。
• 电表是抄表，水表部分是抄表，部分是主动上报
  • 4G、NB 水表是设置上报周期 其余通过系统抄表
  • 电表可以最多设置到每小时执行一次抄表
  • 水表一般是 每天执行一次抄表/上报，有的部分可能是 一周或者半个月 具体 可了解产品
• 是否可以关闭水表的上报限制？ ---- 不可以,主要考虑电池续航，
• 接入方是否需要定时调用 异步抄表接口？ （不需要，抄表历史数据接口即可）
• 可不可以取消后台的定时抄表？只通过异步接口抄表 ---- 不可以，后台定时任务是必须的。系统数据更新，报表计算都依赖于定时抄表。
• 系统保留每个设备每天至少一条抄表数据，在这基础上，接口记录 不定期删除，系统抄表数据 保存一个月左右。

定时抄表系统菜单

具体设置可以联系销售或者是客服

参数档案、价格档案

• 接口操作/设置这部分，系统都不会更新维护对应的数据。
• 若要实现双方统一 可以通过系统操作/设置，后通过 参数档案、价格档案获取,
• 为什么接口操作/设置这部分，系统不维护，对应的数据 ？ ------ 没有必要所有的异步操作都有回调给到所有的用户，用户有了回调之后没有必要再来看我们的系统状态，属于绕弯路