查询用户身份信息
使用场景: 用户登录授权完成后,第三方应用可通过此接口查询用户身份信息
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 否 | |
用户凭证 | 支持 | |
机构凭证 | 未支持 | - |
请求方式: GET(HTTPS)
请求地址: https://oapi.epaas.qq.com/account/userinfo?access_token=ACCESS_TOKEN
请求参数:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证,使用用户凭证(用户态access_token) |
返回参数:
参数 | 类型 | 说明 |
---|---|---|
errcode | int | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
user_name | string | 用户姓名昵称 |
role_id | uint32 | 角色id, 11: 学生; 12: 老师; 13: 家长 |
userid | string | 用户id,在机构内唯一 |
corpid | uint64 | 教育号平台 CorpId |
avatar | string | 用户头像链接 |
corp_type | uint32 | 当前机构类型, 0:DEFAULT; 1:代理商; 2:上级单位; 4:学校; 5:超管; |
corp_name | string | 机构名称 |
child_id | uint32 | 孩子的用户id(家长身份登录时返回) |
login_factors | []string | 登录因子 |
返回示例:
{
"errcode": 0,
"errmsg": "ok",
"user_name": "用户1",
"appid": "10000",
"role_id": 12,
"userid": "30000000",
"corpid": 80000,
"avatar": "https://smart20-1253364609.cos.ap-beijing.myqcloud.com/2021/202106/20210616/EWaAeXFz46b_yY7QwG.png",
"corp_type": 4,
"corp_name": "测试学校",
"child_id": "20000000",
"login_factors": [
"CLASS_CODE"
]
}