获取访问用户身份

GET

http://127.0.0.1/cgi-bin/service/getuserinfo3rd

智慧硬件开发/身份验证/网页授权登录

最后修改时间：2022-08-30 03:03:36

责任人：未设置

权限说明：
跳转的域名须完全匹配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

请求参数

Query 参数

code

string

必需

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

示例值:

suite_access_token

string

必需

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

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'http://127.0.0.1/cgi-bin/service/getuserinfo3rd?code={{code}}&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一起返回

示例

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

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

🟢200出错示例

标签通知事件标签成员变更事件

获取访问用户敏感信息