电表清零接口文档

接口链接

URL地址: http://api2.tqdianbiao.com/Api_v2/ele_security/reset

意义

• 电表清零接口用于电表的清零操作，通过该接口可以将电表的计量数据清零，使得电表的计量数据重新从0开始。
• 注意 预付费电表 清零时会 拉闸
• 新预付费表开始启用时都要进行清零、开户、充值

接口参数

字段名	变量名	必填	类型	描述
授权码	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字段说明

字段名	变量名	必填	类型	描述
预付费模式	paymentmode	否	String	电表计量模式，预付费 default (默认值) ，后付费 noprepay, 付费模式
户号	account_id	否	String	户号

同步返回结果

字段名	变量名	必填	类型	描述
返回状态码	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

{
  "auth_code": "37577f8fb62a7b14ba55cc6faec5a142",
  "timestamp": "1586740681",
  "request_content": [
    {
      "opr_id": "a1ca6ed8ce26488a9f00efb35c4799d9",
      "time_out": 0,
      "must_online": true,
      "retry_times": 1,
      "cid": "19020618114",
      "address": "000066660942",
      "params": {
        "paymentmode": "noprepay"
      }
    }
  ],
  "notify_url": "http://115.221.11.179:8022/notify",
  "sign": "fee536cf6a37a200d6761df04f5bf368"
}

接口测试工具