获取家校访问用户身份

GET

https://qyapi.weixin.qq.com/cgi-bin/school/getuserinfo

该接口用于根据code获取家长或者学生信息

权限说明：
跳转的域名须完全匹配access_token对应应用的可信域名，否则会返回50001错误。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://qyapi.weixin.qq.com/cgi-bin/school/getuserinfo'

响应示例

200 - 当用户为学校的家长时 - 当用户为学校的家长时

{
  "errcode": 0,
  "errmsg": "ok",
  "DeviceId": "DEVICEID",
  "parent_userid": "parent_userid"
}

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

code

string

可选

通过成员授权获取到的code，最大为512字节。每次成员授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。

示例值:

CODE

返回响应

🟢200当用户为学校的家长时

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

DeviceId

string

必需

手机设备号(由企业微信在安装时随机生成，删除重装会改变，升级不受影响)

parent_userid

string

必需

家校通讯录里家长的userid

🟢200当用户为学校的学生时

🟢200出错

修改于 2022-12-02 02:33:08

获取访问用户身份-企业内部开发

创建学生