获取访问用户身份

GET

/cgi-bin/service/getuserinfo3rd

服务端API第三方应用开发

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

文档ID: 16882
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/91711

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://qyapi.weixin.qq.com/cgi-bin/service/getuserinfo3rd? suite_access_token=SUITE_ACCESS_TOKEN&code=CODE'

响应示例

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

{
  "errcode": 0,
  "CorpId": "string",
  "UserId": "string",
  "DeviceId": "string",
  "errmsg": "string"
}

请求参数

Query 参数

suite_access_token

必需

第三方应用的suite_access_token，

示例值:

SUITE_ACCESS_TOKEN

code

必需

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

示例值:

CODE

返回响应

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

application/json

Body

errcode

integer <int32>

返回码

可选

CorpId

string

可选

用户所属企业的corpid

UserId

string

可选

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

DeviceId

string

可选

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

errmsg

string

可选

对返回码的文本描述内容

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

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

🟢200出错返回

修改于 2022-01-14 04:25:49

获取家校访问用户身份

创建学生