网易云信IM账号
网易云信IM账号调用说明
App:开发者app客户端;
AppServer:开发者app服务端;
网易云信webserver:网易云信后台web服务;
网易云信imserver:SDK直连的IM服务。
注:
网易云信IM账号:以下文档中也称为“用户帐号”,参数名用“accid”或”account“等表示。
token:网易云信IM账号的密码。创建 IM accid时可以由开发者app的服务端指定。若未指定,则云信会自动生成一个IM token,并返回给开发者。客户端登录时,需要传参accid与token给云信服务器鉴权。token没有过期的概念,除非人为更改。只有最新的token才是唯一有效的。当登录时使用非最新的token,将会返回的错误码 302。
客户端通过网易云信SDK连接登录云信服务器时,需要保证网易云信IM账号已经注册, 且确保客户端从自己的服务器已经取得了有效token;
创建网易云信IM账号
请求说明
POST https://api.netease.im/nimserver/user/create.action HTTP/1.1
Content-Type:application/x-www-form-urlencoded;charset=utf-8
请求中Headers的设置请参考接口概述
接口描述
1.第三方帐号导入到网易云信平台。注册成功后务必在自身的应用服务器上维护好accid与token。
2.注意IM accid,name长度以及考虑管理IM token。
3.云信应用内的accid若涉及字母,请一律为小写,并确保服务端与所有客户端均保持小写。
参数说明
参数类型必须说明
accidString是网易云信IM账号,最大长度32字符,必须保证一个
APP内唯一(只允许字母、数字、半角下划线_、
@、半角点以及半角-组成,不区分大小写,
会统一小写处理,请注意以此接口返回结果中的accid为准)。
nameString否网易云信IM账号昵称,最大长度64字符。
propsString否json属性,开发者可选填,最大长度1024字符。该参数已不建议使用。
iconString否网易云信IM账号头像URL,开发者可选填,最大长度1024
tokenString否网易云信IM账号可以指定登录IM token值,最大长度128字符,
并更新,如果未指定,会自动生成token,并在
创建成功后返回
signString否用户签名,最大长度256字符
emailString否用户email,最大长度64字符
birthString否用户生日,最大长度16字符
mobileString否用户mobile,最大长度32字符,非中国大陆手机号码需要填写国家代码(如美国:+1-xxxxxxxxxx)或地区代码(如香港:+852-xxxxxxxx)
genderint否用户性别,0表示未知,1表示男,2女表示女,其它会报参数错误
exString否用户名片扩展字段,最大长度1024字符,用户可自行扩展,建议封装成JS