异步回调

通知格式

{
    response_content:"回复内容",//string 格式化的json字符串（必填）
    timestamp: 1521688597 ,//int 服务器时间戳 （必填）
    sign:"efg...",//string 签名 (必填)
}

状态对照表

status状态码	简介
NOTFOUND	未找到
ACCEPTED	已接受任务
QUEUE	队列中
PROCESSING	执行中
DELIVERED	已执行
SUCCESS	成功
NOTSUPPORT	设备不支持
FAIL	失败
TIMEOUT	任务超时
CANCELED	取消
RESPONSE_TIMEOUT	设备响应超时
RESPONSE_FAIL	设备响应失败
UNKOWN	未知

响应回调

通知接收时 只需要回复 SUCCESS 即可。回复 FAIL 或 返回的http状态码statusCode不是 200 过一段时间继续发送此通知，直到成功或达到限制次数。

回调常见问题

• 没有收到回调

  • 系统后台 主菜单>接口授权>Api请求记录 页面 可以查看接口记录 ⭐
    • 推荐检查下 回调地址
    • 确认下接口是否调用成功

• 回调时间，系统执行成功，或者失败，超时，都会立即回调，一直没有回调那就是一直没有执行。

• 回调通知被合并到一起了

  • 如果任务是一起完成的那么会合并到一起回调给调用方 （回调数据主体是个数组）

• 批量任务调用接口可能不会同时回调，因为不是同时完成的 (部分没有执行，比如 离线，可是这也是 属于不是同时完成的)

• 重复回调， 回调时响应超时或者响应错误

• 回调成功一定是执行了的

• 抄表、操作接口都是异步的，执行结果通过回调给出。

• 通过opr_id 关联设备 调用接口时存好 opr_id 的关联关系（调用记录）

• 需要激活的水表激活后执行后回调，其他表一般几秒就会回调

• 如何确认自己的设备 是否需要激活？ --- 联系销售经理或者客服

• 如何确认是否激活成功？ 激活成功后接口记录会中对应的状态会有显示执行状态，接口会回调

• 激活无效 --- 联系销售经理或者客服

• 每次都要去激活吗？ -- 不用 水表会定期自动激活 （调试阶段每次都要手动激活）

• PS: 一般水表接口调用方可以不用定时抄表，系统里设置好定时抄表/上报后，获取定时抄表记录即可

提示

• 一直发某个链接，因为这个链接中的内容基本解答了问题,仔细阅读下。

IP &&　白名单

如果有添加白名单限制需求　我们的回调服务器IP　为　139.224.191.69、139.196.231.100