开放平台API对接注意事项

最新版本API细节说明:

java SDK目前为单独引入的jar包,maven为依赖,库未能开放,须知。
区域事件和围栏事件是进出相关边界才会触发并推送相关消息,须知。

接口文档:
1、X-token获取方式 :
加密第三次 { accessToken+ 加密第二次[ singnId +(加密第一次accessToken得到的值)] + 时间戳 }
以上参数都为2.2获取AccessToken得到参数
返回值expireAt为时间戳

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

2、最新API下档下载地址:
https://open.joysuch.com/#/index/document/detail/1675055829082?menuName=%E5%BC%80%E5%8F%91-%E6%8E%A5%E5%8F%A3-%E6%96%87%E6%A1%A3%E4%B8%8B%E8%BD%BD

3、定位API:
参数timePeriod=-1时,代表返回的参数为最后上线的定位信息,如果终端实时在线,则推送当前时间的终端位置,如最后离线时间是之前,那推送的位置为之前最后上线位置。

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

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

  1. 提前打开开放平台推送日志,检查serverUrl(客户订阅的那端IP),检查是否存在网络、防火墙安全策略等网络问题导致
  2. 订阅后检查终端是否正常上线,是否平台推送相关消息,如果推送消息时间大于订阅时间,消息则不会正常推送
  3. 云端消息推送五次不成功,则会拉黑客户端ip,需要重新订阅

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

  1. 检查服务器41616端口是否打开,客户端如果使用mq订阅成功,登录平台48161端口即可看到客户端所mq的队列和推送的数据量。
  2. 队列命名规则: Consumer.项⽬标识.VirtualTopic.T-SUBS-建筑ID

本地项目可结合推送日志一起排查推送不成功具体原因,云端http订阅无法查询推送日志(云端服务器数据量过大,保留时间只有半天不到,历史日志无法查询),目前只能通过推送日志返回值排查原因。

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