获取访问用户身份

GET

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

权限说明：
跳转的域名须完全匹配suite_access_token 对应第三方应用的可信域名，否则会返回50001错误。
文档ID: 15122
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/91121
https://open.work.weixin.qq.com/api/doc/90002/90151/91155

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://qyapi.weixin.qq.com/cgi-bin/service/auth/getuserinfo3rd?code={{code}}&suite_access_token='

响应示例

200 - a) 当用户属于某个企业 - 异常示例

{
    "errcode": 40029,
    "errmsg": "invalid code"
}

请求参数

Query 参数

code

必需

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

示例值:

suite_access_token

必需

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

示例值:

返回响应

🟢200a) 当用户属于某个企业

application/json

Body

errcode

integer <int32>

返回码

可选

user_ticket

string

可选

成员票据，最大为512字节。 scope为snsapi_userinfo或snsapi_privateinfo，且用户在应用可见范围之内时返回此参数。后续利用该参数可以获取用户信息或敏感信息，参见“第三方使用user_ticket获取成员详情”。

CorpId

string

可选

用户所属企业的corpid

UserId

string

可选

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

DeviceId

string

可选

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

errmsg

string

可选

对返回码的文本描述内容

open_userid

string

可选

全局唯一。对于同一个服务商，不同应用获取到企业内同一个成员的open_userid是相同的，最多64个字节。仅第三方应用可获取

expires_in

integer <int32>

可选

user_ticket的有效时间（秒），随user_ticket一起返回

🟢200b) 若用户不属于任何企业

🟢200出错示例

修改于 2022-12-06 07:25:10

构造网页授权链接

获取访问用户敏感信息