目录

新版群组/聊天室服务 REST API差异说明v2

(最新更新时间: 2017-01-06)

第一版差异说明发出后,我们收到了一些开发者的反馈。根据这些反馈,我们对新版群组/聊天室的异常、状态码进行了调整和优化。相比2017-01-03第一个版本,主要更新内容:

相比2017-01-03第一个版本,异常及状态码有改动的接口如下:

群组服务

成员操作

群加人(单加/批量),用户不存在

群加人(单加/批量),用户已经在群里

群减人(单减/批量减)被减用户(存在但)都不在群

转让群主

转让群主,自己转自己

转让群主,转给一个不在群里的用户

转让群主,转给一个群里的其他成员

黑名单操作

添加黑名单(单个/批量), 用户不是群成员

把群主加入黑名单

聊天室服务

聊天室信息维护

创建聊天室,聊天室成员不存在,旧群组服务返回400,新群组服务返回404

删除聊天室,聊天室id不存在

修改聊天室信息,聊天室id不存在

修改聊天室信息,修改的字段含有不允许修改的字段,例如id

删除不存在的聊天室

成员操作

聊天室加人(单加/批量),聊天室不存在

聊天室加人(单加/批量),被添加用户都不存在,或某个成员不存在

聊天室减人,被删除成员不在聊天室

聊天室减人(单减/批量减),聊天室id不存在

限制检查

用户创建群组/聊天室,群组/聊天室加人等操作,会检查如下参数:

超过限制的异常:

新版异常描述为:

权限检查

所有群组/聊天室的接口,如果调用者不具备相应接口的调用权限, 抛出的异常类型:com.easemob.group.exception.GroupAuthorizationException,状态码为 401


上一页:聊天室管理