获取家校访问用户身份

GET

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

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

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

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

{
    "errcode": 0,
    "errmsg": "ok",
    "parents": [
        {
            "corpid": "wxCorpId1",
            "parent_userid": "zhangsan"
        },
        {
            "corpid": "wxCorpId2",
            "parent_userid": "lisi"
        }
    ]
}

请求参数

Query 参数

suite_access_token

string

可选

第三方应用的suite_access_token，参见“获取第三方应用凭证”

示例值:

SUITE_ACCESS_TOKEN

code

string

可选

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

示例值:

CODE

返回响应

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

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

parents

array [object {2}]

家长列表

必需

corpid

string

必需

家长所在学校的corpid

parent_userid

string

必需

家长在家校通讯录里的parent_userid

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

🟢200出错

修改于 2022-12-07 02:38:29

构造网页授权链接

获取访问用户身份