注册用户
客户端在与即时通讯服务端建立连接时必须传入用户在即时通讯服务的身份验证令牌（Token）。Token 是用户在即时通讯服务中的唯一身份标识，无论是使用即时通讯服务或是实时音视频服务，均需要使用该 Token。获取 Token 即表示一个用户在即时通讯服务中完成注册。
在开始之前，我们建议先阅读用户概述，以了解用户管理的相关接口、服务及配置。
获取 Token
客户端 SDK 不提供获取 Token 的 API。您需要在应用服务端（App Server）集成即时通讯服务端获取 Token API，实现获取 Token 的业务逻辑。
成功获取 Token 后，由您的应用服务端将 Token 分发给客户端。客户端在连接即时通讯服务端时使用。Token 在有效期内都可以正常使用。关于 Token 有效期的详细描述，详见作废 Token。
同一个用户 ID 可多次获取 Token，如果 Token 在有效期内，均可用于连接即时通讯服务。App 获取、使用 Token 进行连接、认证的参考方案与 UML 流程图可参考下文使用 Token。通过 App 层定义的用户 ID（userId）换取即时通讯服务中使用的身份验证 Token。同一用户 ID 如需重新获取 Token 使用同一接口。
一旦您在控制台刷新 App Secret ，App Key 下已获取的 Token 均会失效。请使用新的 App Secret 生成 API 签名，并重新获取 Token。
请求方法
POST： https://数据中心域名/user/getToken.json
签名规则： 所有服务端 API 请求均需要进行规则校验，详见 API 请求签名。
频率限制： 每秒钟限 200 次
正文参数
HTTP 请求正文数据格式为 application/x-www-form-urlencoded，支持以下 HTTP 表单参数：
用户信息托管服务已默认开通。获取 Token 时传入的用户名称（name）和头像（portraitUri ）会写入托管用户信息，并用于移动端远程推送。如需变更用户名称和头像，建议调用修改用户信息接口。重新获取 Token 时，如果传入新的 name 或 portraitUri，对应的托管用户信息也会更新。
| 参数 | 类型 | 必传 | 说明 |
|---|---|---|---|
userId | String | 是 | App 自行定义的用户 ID，用于换取 Token。支持大小写英文字母与数字的组合，最大长度 64 字节。 |
name | String | 是 | 用户名称，将写入托管用户信息并用于推送服务。不区分符号、英文字符、中文字符，统一限制最多 64 个字符。 |
portraitUri | String | 否 | 用户头像 URI，将写入托管用户信息并用于推送服务，最大长度 1024 字节。 |
- 建议使用不包含个人信息、无明显规律且难以猜测的内部唯一标识作为
userId。 - 不要直接使用手机号、身份证号等敏感个人信息作为
userId，避免因标识传播或泄露造成个人信息安全风险。 - 不要使用连续数字或其他易于枚举的规则生成
userId。在单聊业务中，只需知道接收方的userId即可向其发送消息，易于猜测的userId可能被恶意利用。 - 部分旧版 Server SDK 中
portraitUri字段为必填项；若不希望填写该字段，请升级 Server SDK 到最新版，或者传一个固定字符即可，比如："_"。
请求示例
POST /user/getToken.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded
userId=jlk456j5&name=Ironman&portraitUri=http%3A%2F%2Fabc.com%2Fmyportrait.jpg
返回结果
HTTP 响应正文包含具有以下结构的 JSON 对象：
| 返回值 | 返回类型 | 说明 |
|---|---|---|
code | Int | 返回码，200 为正常。 |
token | String | 用户身份验证 Token，长度在 256 字节以内，可以保存应用内。Token 中携带 IM 服务动态导航地址，开发者不需要进行处理。 |
userId | String | 返回输入参数中提供的用户 ID。 |
返回结果示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"code":200, "userId":"jlk456j5", "token":"sfd9823ihufi"}
使用 Token
用户的注册需要通过用户 ID 换取 Token。注册时传入的用户名称和头像会由用户信息托管服务保存。
您的 App 客户端需要在建立 IM 连接时处理 Token 失效的情况，并且在 Token 失效时请求应用服务端重新获取 Token。
以下提供了基于 Token 认证与连接的方案，供您参考。
首次连接时获取 Token
应用获取 Token 后，根据情况可选择在应用本地保留当前用户的 Token。流程如下：
非首次连接时使用已有 Token
后续登录过程中，不必再向即时通讯服务端请求 Token，由应用服务端直接提供之前保存过的 Token。
- 请实现重新向服务器获取 Token 的代码逻辑，以处理 Token 失效的情况。
- Token 具有有效期，默认为永久有效，可在控制台进行修改。
- 刷新 App Secret、作废 Token 均可使已有 Token 失效。
如果您的 App 是免登录设计，也可以将 Token 保存在 App 本地（注意保证本地数据存储安全），直接登录。