查询用户身份信息
使用场景: 用户登录授权完成后,第三方应用可通过此接口查询用户身份信息
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 否 | |
| 用户凭证 | 支持 | |
| 机构凭证 | 未支持 | - |
请求方式: 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"
]
}