安全认证签名
功能概述
安全模式下,需要使用安全认证签名token才能加入频道,正常情况下:
1、 由客户端向应用服务器发起安全认证签名的请求。该步骤交互由开发者自行完成。
2、 应用服务器向云信服务器请求安全认证签名token。具体见下文。
3、 请求成功后,应用服务器将获取到的token返回给客户端。
4、 客户端携带token加入频道。
接口说明
POST https://api.netease.im/nimserver/user/getToken.action HTTP/1.1
Content-Type:application/x-www-form-urlencoded;charset=utf-8
参数说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
uid | long | 是 | 用户帐号 |
repeatUse | Boolean | 否 | 是否可以重复使用,默认为true |
expireAt | int | 否 | 过期时间,默认600秒,最大86400秒 |
channelName | String | 否 | 绑定的频道名称 |
注意事项:
- repeatUse:表示在过期时间内该用户可以多次使用该token。
- expireAt:表示token的有效期限。请注意:过期后,该用户将无法通过此token加入频道。
- channelName:对应的频道名称。若不传,则该用户可以使用该token加入任意频道。
- 在token过期之前, 该uid 再次调用此接口(channelName的设置继续保持一致)获取到的token不会发生改变,但过期时间将会刷新为所传入的expireAt。
curl请求示例
curl -X POST -H "AppKey: go9dnk49bkd9jd9vmel1kglw0803mgq3" -H "Nonce: 4tgggergigwow323t23t" -H "CurTime: 1443592222" -H "CheckSum: 9e9db3b6c9abb2e1962cf3e6f7316fcc55583f86" -H "Content-Type: application/x-www-form-urlencoded" -d 'uid=123456' 'https://api.netease.im/nimserver/user/getToken.action'
请求中Headers的传参要求请参考接口概述。
返回说明
Http响应JSON格式:
"Content-Type": "application/json; charset=utf-8"
{
"code":200,
"token":"xxxxx" //安全认证模式下的签名。
}
本篇文档内容是否对您有帮助?


此文档对你是否有帮助
×


×