用户概述
App 用户需要接入即时通讯服务，才能使用即时通讯服务。对即时通讯服务来说，用户是指持有由即时通讯服务端分发的有效 Token，接入并使用即时通讯服务的 App 用户。
注册用户
应用服务端（App Server）应向即时通讯服务端提供 App 用户的用户 ID（userId），以向即时通讯服务端换取唯一用户 Token。对即时通讯服务来说，这个以 userId 获取 Token 的步骤即注册用户，且必须通过调用 Server API 来完成。
应用客户端必须持有有效 Token，才能成功连接到即时通讯服务端，使用即时通讯服务。当 App 客户端用户向服务器发送登录请求时，服务器会查询数据库以检查连接请求是否匹配。
注册用户数限制
删除用户
删除用户是指在应用的开发环境中，通过控制台删除已注册的测试用户，以控制开发环境中的测试用户总数。生产环境不支持该操作。
注销用户
注销用户是指在即时通讯服务中删除用户数据。App 可使用该能力实现自身的用户销户功能，满足 App 上架或合规要求。
即时通讯服务返回注销成功结果后，与用户 ID 相关数据即被删除。您可以向即时通讯服务端查询所有已注销用户的 ID。如有需要，您可以重新激活已被注销的用户 ID（注意，用户个人数据无法被恢复）。
仅 IM Server API 提供上述能力。
用户信息
用户信息泛指用户的昵称、头像，以及群组的群昵称、群头像等数据。您需要自行维护用户信息数据。即时通讯服务端不提供用户信息托管维护服务。
IMKit SDK 中仅提供与展示用户信息相关的客户端接口。
好友关系
App 用户之间的好友关系需要由应用服务器（App Server）自行维护。即时通讯服务不会同步或保存 App 端的好友关系数据。
如果需要对客户端用户之间的消息收发行为进行限制（例如，App 的所有 userId 泄漏，导致某个恶意用户可越过好友关系向任意用户发送消息），可以考虑使用用户白名单服务。用户一旦开启并设置白名单，则仅可接收来自该白名单中用户的消息。
用户管理接口
| 功能分类 | 功能描述 | 服务端 API |
|---|---|---|
| 注册用户 | 使用 App 用户的用户 ID 向即时通讯服务端换取 Token。 | 注册用户 |
| 删除用户 | 参见上文删除用户。 | 不提供该 API |
| 废弃 Token | 废弃在特定时间点之前获取的 Token。 | 作废 Token |
| 注销用户 | 注销用户是指在即时通讯服务中停用用户 ID，并删除用户个人数据。 | 注销用户 |
| 查询已注销用户 | 获取已注销的用户 ID 列表。 | 查询已注销用户 |
| 重新激活用户 ID | 在即时通讯服务中重新启用已注销用户的 ID。 | 重新激活用户 ID |
| 设置即时通讯服务端的用户信息 | 设置在即时通讯的推送服务中使用的用户名称与头像。 | 未提供单独的设置接口。在注册用户时必须提供用户信息。 |
| 获取即时通讯服务端的用户信息 | 获取用户在即时通讯服务中注册的信息，包括用户创建时间和服务端的推送服务使用的用户名称、头像 URL。 | 获取信息 |
| 修改即时通讯服务端的用户信息 | 修改在即时通讯的推送服务中使用的用户名称与头像。 | 修改信息 |
| 封禁用户 | 禁止用户连接到即时通讯服务，并立即断开连接。可按时长解封或主动解封。查询被封禁用户的用户 ID、封禁结束时间。 | 添加封禁用户、解除封禁用户、查询封禁用户 |
| 查询用户在线状态 | 查询某用户的在线状态。 | 查询在线状态 |
| 加入黑名单 | 在用户的黑名单列表中添加用户。在 A 用户黑名单的用户无法向 A 发送消息。 | 加入黑名单 |
| 移出黑名单 | 在用户的黑名单中移除用户。 | 移出黑名单 |
| 获取黑名单列表 | 获取用户的黑名单列表。 | 查询黑名单 |
| 用户白名单 | 用户一旦开启并设置白名单，则仅可接收来自该白名单中用户的消息。 | 开启用户白名单、用户白名单状态查询、添加白名单、移出白名单、查询白名单 |
仅黑名单功能提供客户端 API。上表其他接口均只提供服务端 API。
131 6185 6839