开放平台API对接注意事项
最新版本API细节说明:
java SDK目前为单独引入的jar包,maven为依赖,库未能开放,须知。
区域事件和围栏事件是进出相关边界才会触发并推送相关消息,须知。
接口文档:
1、X-token获取方式 :
加密第三次 { accessToken+ 加密第二次[ singnId +(加密第一次accessToken得到的值)] + 时间戳 }
以上参数都为2.2获取AccessToken得到参数
返回值expireAt为时间戳
接⼝请求⽅式为POST,请求数据格式为json,返回数据格式为json,统⼀编码为UTF-8。
加密都为32位小写加密
3、定位API:
参数timePeriod=-1时,代表返回的参数为最后上线的定位信息,如果终端实时在线,则推送当前时间的终端位置,如最后离线时间是之前,那推送的位置为之前最后上线位置。
4、消息订阅与推送常见问题:
http订阅收不到订阅消息可按照以下路线排查:
提前打开开放平台推送日志,检查serverUrl(客户订阅的那端IP),检查是否存在网络、防火墙安全策略等网络问题导致
订阅后检查终端是否正常上线,是否平台推送相关消息,如果推送消息时间大于订阅时间,消息则不会正常推送
云端消息推送五次不成功,则会拉黑客户端ip,需要重新订阅
MQ订阅收不到订阅消息可按照以下路线排查:
检查服务器41616端口是否打开,客户端如果使用mq订阅成功,登录平台48161端口即可看到客户端所mq的队列和推送的数据量。
队列命名规则: Consumer.项⽬标识.VirtualTopic.T-SUBS-建筑ID
本地项目可结合推送日志一起排查推送不成功具体原因,云端http订阅无法查询推送日志(云端服务器数据量过大,保留时间只有半天不到,历史日志无法查询),目前只能通过推送日志返回值排查原因。
转载请注明作者和出处,并添加本页链接。
原文链接:
//svn.seekcy.com:33382/526