用户注册与登录
小于 1 分钟
REST API
用户注册与登录
本文介绍用户注册模式与登录方式。
用户注册模式
即时通讯 IM 提供以下两种方式创建用户:
- 调用 RESTful API 注册用户账号,注册后保存到你的服务器或返给客户端。 
- 在声网控制台上创建用户。 
创建用户
在声网控制台按照如下步骤创建用户:
- 展开控制台左上角下拉框,选择需要开通即时通讯 IM 服务的项目。 
- 点击左侧导航栏的全部产品。 
- 在下拉列表中找到即时通讯 IM 并点击。 
- 在即时通讯 IM 页面,进入运营管理标签页。 
- 在用户 页签下,点击创建IM用户。 
- 在弹出的对话框中,配置用户相关参数,点击确定。 

获取用户 token
创建用户后,在用户列表点击对应的用户的操作一栏中的更多,选择查看Token。
在弹出的对话框中,可以查看用户 Token,也可以点击重新生成,生成用户 token。

用户登录
初始化即时通讯 IM SDK 后,你需要调用登录接口进行登录。只有登录成功后,你才能正常使用 IM 的各种功能,例如消息和会话。
目前登录服务器支持主动和自动登录。主动登录有两种方式:
- 用户 ID + 密码
- 用户 ID + token
| 参数 | 类型 | 是否必需 | 描述 | 
|---|---|---|---|
| username | String | 是 | 用户 ID,长度不可超过 64 个字节。不可设置为空。支持以下字符集: - 26 个小写英文字母 a-z; - 26 个大写英文字母 A-Z; - 10 个数字 0-9; - “_”, “-”, “.”。 注意 
 | 
| token | String | 是 | token 可以通过调用 REST API 获取,即传入用户 ID (或用户 ID + 密码)和 token 有效期参数获取,详见 使用 token 验证。 | 
| password | String | 是 | 用户的登录密码,长度不可超过 64 个字符。 | 
登录流程
- 用户 ID + 密码

- 用户 ID + Token

提示
关 token 鉴权,详见 使用 Token 鉴权。