====== 用户体系集成 ======

''本文档已不再维护，新版文档见：[[ccim:rest:accountsystem|用户体系集成]]。''

-------

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

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

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

REST 接口参考文档：

[[ http://docs-im.easemob.com/im/server/ready/user#%E6%B3%A8%E5%86%8C%E5%8D%95%E4%B8%AA%E7%94%A8%E6%88%B7_%E6%8E%88%E6%9D%83 | 注册用户]]

[[ http://docs-im.easemob.com/im/server/ready/user#%E5%88%A0%E9%99%A4%E5%8D%95%E4%B8%AA%E7%94%A8%E6%88%B7 | 删除用户]]

[[ http://docs-im.easemob.com/im/server/ready/user#%E4%BF%AE%E6%94%B9%E7%94%A8%E6%88%B7%E5%AF%86%E7%A0%81 | 修改用户密码]]

[[ http://www.easemob.com/pricing/im#p01 | 参考链接]]

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

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

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

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

REST接口参考文档：

[[ http://docs-im.easemob.com/im/server/ready/user#%E5%A5%BD%E5%8F%8B%E4%B8%8E%E9%BB%91%E5%90%8D%E5%8D%95 | 好友与黑名单]]

SDK参考文档：

[[ http://docs-im.easemob.com/im/android/basics/buddy | Andrioid好友管理]]

[[ http://docs-im.easemob.com/im/ios/basics/buddy | iOS好友管理]]