获取用户基本信息
出自中南e行公众平台开发者文档
在关注者与公众号产生消息交互后,公众号可获得关注者的OpenID(加密后的中南e行号,每个用户对每个公众号的OpenID是唯一的。对于不同公众号,同一用户的openid不同)。公众号可通过本接口来根据OpenID获取用户基本信息,包括昵称、头像、性别、所在城市、语言和关注时间。
获取用户OpenID
开发者可通过学号获取用户OpenID。请使用http协议。
接口调用请求说明
http请求方式: GET http://app.its.csu.edu.cn/mqtt/cgi-bin/user/app/openid?access_token=ACCESS_TOKEN&&userId=userId
参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
userId | 是 | 用户工号 |
返回说明
正常情况下,中南e行会返回下述JSON数据包:
{ "opendId":"EjwRVPcsSYuwieEdf", }
参数说明
参数 | 说明 |
---|---|
openId | 用户的标识,对当前公众号唯一 |
无openId时中南e行会返回空JSON,JSON数据包示例如下:
{}
获取用户基本信息
开发者可通过OpenID来获取用户基本信息。请使用http协议。
接口调用请求说明
http请求方式: GET http://app.its.csu.edu.cn/mqtt/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID
参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
openid | 是 | 普通用户的标识,对当前公众号唯一 |
返回说明
正常情况下,中南e行会返回下述JSON数据包给公众号:
{ "type":"S", "userId":"197535", "userName":"游赛", "sex":"男", "headImg": "http://app.its.csu.edu.cn/fe/upload/mobile_SC/HEAD_IMG/pic_12341.0430772680430986E9.JPG", "dept":"软件学院", "profName":"软件工程", "className":"软件工程1202", "realUserId":"1234", "openId":"R9Q9e2iiJjTUie" }
参数说明
参数 | 说明 |
---|---|
type | S: 学生 T:教职工 |
openid | 用户的标识,对当前公众号唯一 |
userId | 用户在中南e行的ID号 |
realUserId | 用户的学工号 |
sex | 用户的性别 |
headImg | 头像 |
dept | 学生:代表学院 教职工:代表部门 |
profName | 专业名称(只适用于学生) |
className | 班级名称(只适合学生) |
错误时中南e行会返回错误码等信息,JSON数据包示例如下(该示例为AppID无效错误):
{"errcode":40013,"errmsg":"invalid appid"}