用户体系集成

本文档已不再维护,新版文档见:用户体系集成


前言:在集成环信时大家都会遇到集成用户体系的问题,环信服务器既不保存任何APP业务数据,也不保存任何APP的用户信息,用户体系的集成主要是在注册登录和好友关系。本文将简要分享下用户体系集成的步骤。

注册

当APP客户端调用APP自己的业务后台创建新用户时,也在环信上为该 APP 用户创建一个环信账号。 通常的做法是在自己 APP 创建用户成功后调用创建环信账号的 REST 接口来创建环信账号。因为这个方法是服务器对服务器的调用,所以因为网络不稳定原因失败的可能很小。但开发者仍旧需要对该方法的返回结果做处理,如果该方法失败,应该做个 retry,如果仍旧失败,应该回滚在自己 APP 创建用户的操作。否则会导致 APP 的用户账号和环信账号不一致的问题。同时 REST 也提供了删除用户和修改用户密码的接口,当APP删除用户或者修改用户密码时候也要同步调用 REST。

正式环境下的appkey,需要把注册模式设置为授权注册,以防被恶意注册。注册的账号不要采用有序的数字,以防被别人恶意发送垃圾消息

REST 接口参考文档:

注册用户

删除用户

修改用户密码

参考链接

登录

当APP客户端登录时,应先登录自己的APP服务器,从后台拿到对应的环信账号再去登录环信。当登录环信成功之后才算是登录成功,不然就需要重新再去登录

好友关系

当需要为用户创建好友关系时,可以通过请求App服务器来调用 REST 接口添加好友,也可以直接调用客户端SDK的api来申请添加好友。两者的区别在于 REST 会直接加为好友,客户端SDK则需要对方在线同意之后才能成为好友。

没有好友关系的账号之间是可以直接发消息,不会因为不是好友而不能聊天

同时黑名单功能环信也是有提供,可以直接把好友加入黑名单,对方发消息就会发送失败

REST接口参考文档:

好友与黑名单

SDK参考文档:

Andrioid好友管理

iOS好友管理