化工平台API对接注意事项

1
最新版本API细节说明:

URL开头的/api/v2/为开放api,/api/v3/为内部对接文档,需要了解项目性质并使用相关文档,须知。
区域事件和围栏事件是进出相关边界才会触发并推送相关消息,须知。

接口文档:

Authorization获取方式

  1. appId + secret组成的字符串由MD5加密一次 后,把加密后的结果,在加密一次,最后全部转成大写

以上参数获取方式如下


加密都为32位加密
接⼝请求⽅式为POST,请求数据格式为json,返回数据格式为json,统⼀编码为UTF-8。

最新API下档下载地址:
点我(最新API下档下载 )

消息订阅与推送常见问题:

当第三方系统需要对接本系统的报警信息,首先需要进行报警订阅,订阅完成后,当本系统产生了报警信息,会根据订阅时传递的推送地址进行推送报警信息。
若推送不成功,会再尝试推送2次,都不成功,则会根据配置文件配置的参数,启用定时任务继续尝试推送,总计5次,都不成功便会放弃推送。
配置文件:application-product.properties
配置参数:alarm.error.push.interval.time 单位毫秒

role 身份 0-员工 1-管理人员 2-企业负责人

http订阅收不到订阅消息可按照以下路线排查:

  1. 使用postman调用相关接口,检查serverUrl(客户订阅的那端IP),检查是否存在网络、防火墙安全策略等网络问题导致
  2. requestServerUrl域名要求:开头为htpp/https/ftp,结尾为com|net|org|edu|int|mil|gov|arpa|biz|aero|name|coop|info|pro|museum|uk|me,其他域名则目前不支持
  3. 订阅后检查终端是否正常上线,是否平台推送相关消息,如果推送消息时间大于订阅时间,消息则不会正常推送

本地项目可结合推送服务器日志一起排查推送不成功具体原因,还存在对接上原因请联系问题小组。

转载请注明作者和出处,并添加本页链接。
原文链接: //svn.seekcy.com:33382/527