差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 后一修订版 两侧同时换到之后的修订记录 | ||
im:other:integrationcases:usersandfriends [2019/06/12 12:39] jk [客户端集成] |
im:other:integrationcases:usersandfriends [2022/07/22 02:32] jennifer.zeng [服务器端集成] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== 已上线的应用导入到环信 ====== | + | ====== 已上线应用的用户体系导入到环信 ====== |
---- | ---- | ||
行 23: | 行 23: | ||
==== 服务器端集成 ==== | ==== 服务器端集成 ==== | ||
- | **将已上线的 APP 的现有用户集成到环信**[[im:server:ready:user|用户管理 REST API]] 提供了一个创建环信账号的 REST 方法。这个方法很简单,只需要提供账号 ID 和密码2个参数,就可以创建一个环信账号。对一个已经上线,已经有很多现有用户的 APP 来说,要集成环信,只需要写一个脚本,循环调用创建环信用户的 REST 方法即可。 | + | **将已上线的 APP 的现有用户集成到环信** [[ccim:rest:accountsystem|用户体系集成 REST API]] 提供了一个创建环信账号的 REST 方法。这个方法很简单,只需要提供账号 ID 和密码 2 个参数,就可以创建一个环信账号。对一个已经上线,已经有很多现有用户的 APP 来说,要集成环信,只需要写一个脚本,循环调用创建环信用户的 REST 方法即可。 |
环信账号中的 username 可以和已有的 APP 用户体系的用户的 primarykey 相同。这样做的好处是不需要对现有 APP 后台的数据库的用户表做任何修改(比如不需要给用户表增加一个叫环信账号 ID 的字段)。 | 环信账号中的 username 可以和已有的 APP 用户体系的用户的 primarykey 相同。这样做的好处是不需要对现有 APP 后台的数据库的用户表做任何修改(比如不需要给用户表增加一个叫环信账号 ID 的字段)。 | ||
- | **APP 创建新用户时创建环信账号 **为保证安全,强烈建议只在服务器端调用创建环信账号的 REST 方法。具体方法见[[im:server:ready:user|用户管理 REST API]]。即每次当APP客户端调用APP自己的业务后台创建新用户时,也在环信上为该 APP 用户创建一个环信账号。 | + | **APP 创建新用户时创建环信账号 **为保证安全,强烈建议只在服务器端调用创建环信账号的 REST 方法。具体方法见 [[ccim:rest:accountsystem|用户体系集成 REST API]]。即每次当APP客户端调用APP自己的业务后台创建新用户时,也在环信上为该 APP 用户创建一个环信账号。 |
通常的做法是在自己 APP 创建用户成功后调用创建环信账号的 REST 方法来创建环信账号。因为这个方法是服务器对服务器的调用,所以因为网络不稳定原因失败的可能很小。但开发者仍旧需要对该方法的返回结果做处理,如果该方法失败,应该做个 retry,如果仍旧失败,应该回滚在自己 APP 创建用户的操作。否则会导致 APP 的用户账号和环信账号不一致的问题。 | 通常的做法是在自己 APP 创建用户成功后调用创建环信账号的 REST 方法来创建环信账号。因为这个方法是服务器对服务器的调用,所以因为网络不稳定原因失败的可能很小。但开发者仍旧需要对该方法的返回结果做处理,如果该方法失败,应该做个 retry,如果仍旧失败,应该回滚在自己 APP 创建用户的操作。否则会导致 APP 的用户账号和环信账号不一致的问题。 | ||
- | **APP 删除用户时删除环信账号**为保证安全,强烈建议只在服务器端调用删除环信账号的 REST 方法。具体方法见[[im:server:ready:user|用户管理 REST API]]。即每次当APP客户端调用APP自己的业务后台删除新用户时,也在环信上将该 APP 用户对应的环信账号删除。 | + | **APP 删除用户时删除环信账号**为保证安全,强烈建议只在服务器端调用删除环信账号的 REST 方法。具体方法见 [[ccim:rest:accountsystem|用户体系集成 REST API]]。即每次当APP客户端调用 APP 自己的业务后台删除新用户时,也在环信上将该 APP 用户对应的环信账号删除。 |
- | **APP 修改用户密码时更新环信账号的密码**为保证安全,强烈建议只在服务器端调用修改环信账号密码的 REST 方法。具体方法见[[im:server:ready:user|用户管理 REST API]]。即每次当 APP 用户的密码被修改时,也要更新该 APP 用户对应的环信账号的密码。 | + | **APP 修改用户密码时更新环信账号的密码**为保证安全,强烈建议只在服务器端调用修改环信账号密码的 REST 方法。具体方法见 [[ccim:rest:accountsystem|用户体系集成 REST API]]。即每次当 APP 用户的密码被修改时,也要更新该 APP 用户对应的环信账号的密码。 |
==== 客户端集成 ==== | ==== 客户端集成 ==== | ||
行 41: | 行 41: | ||
===== 好友体系导入环信 ===== | ===== 好友体系导入环信 ===== | ||
- | 所谓好友体系,是指谁是谁的好友的关系体系。环信提供好友体系,但不是必须使用的。比如对一个企业内部移动办公 APP 来说,因为企业内部同事是彼此认识的,那么此 APP 可能是不需要消息发送权限控制的。即任何人都可以给任何人发消息。但一个交友类的 APP 就必须要控制只有我的好友才能给我发消息,不是我的好友的人需要向我发送加好友邀请,我批准后才能给我发消息。这种情况下,就需要启用环信提供的好友体系。 | + | 所谓好友体系,是指谁是谁的好友的关系体系。环信提供好友体系,但不是必须使用的。 |
==== 服务器端集成 ==== | ==== 服务器端集成 ==== | ||