php获取企业微信成员userid,获取访问用户身份

请求方式：GET(HTTPS)

请求地址：https://qyapi.weixin.qq.com/cgi-bin/service/getuserinfo3rd?suite_access_token=SUITE_ACCESS_TOKEN&code=CODE

参数说明：

参数

必须

说明

suite_access_token

是

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

code

是

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

权限说明：

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

返回结果：

a) 当用户属于某个企业，返回示例如下：

{

"errcode": 0,

"errmsg": "ok",

"CorpId":"CORPID",

"UserId":"USERID",

"DeviceId":"DEVICEID",

}参数

说明

errcode

返回码

errmsg

对返回码的文本描述内容

CorpId

用户所属企业的corpid

UserId

用户在企业内的UserID，如果该企业与第三方应用有授权关系时，返回明文UserId，否则返回密文UserId

DeviceId

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

b) 当用户为学校的家长时，返回示例如下：

{

"errcode": 0,

"errmsg": "ok",

"CorpId":"CORPID1|CORPID2",

"DeviceId":"DEVICEID",

"external_userid": "abcexuserid",

"parents":[

{

"corpid": "wxCorpId1",

"parent_userid": "zhangsan"

},

{

"corpid": "wxCorpId2",

"parent_userid": "lisi"

}

]

}参数

说明

errcode

返回码

errmsg

对返回码的文本描述内容

DeviceId

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

CorpId

用户是家长时，返回的是家长关注的学校corpid列表，多个corpid用‘|’分隔。注：当家长从某个学校进入应用时，只返回该学校的corpid。

external_userid

家长的外部联系人id，开发者再通过获取外部联系人详情接口可以取到foreign_key，该字段就是对应家校通讯录里面的家长userid

parents

家长列表

parents.corpid

家长所在学校的corpid

parents.parent_userid

家长在家校通讯录里的parent_userid

c) 若用户不属于任何企业，返回示例如下：

{

"errcode": 0,

"errmsg": "ok",

"OpenId":"OPENID",

"DeviceId":"DEVICEID"

}参数

说明

errcode

返回码

errmsg

对返回码的文本描述内容

OpenId

非企业成员的标识，对当前服务商唯一

DeviceId

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

出错返回示例：

{

"errcode": 40029,

"errmsg": "invalid code"

}