获取访问用户敏感信息

POST

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

自建应用与代开发应用可通过该接口获取成员授权的敏感字段

权限说明：
成员必须在应用的可见范围内。

参数说明：

注：对于自建应用与代开发应用，敏感字段需要管理员在应用详情里选择，且成员oauth2授权时确认后才返回。敏感字段包括：性别、头像、员工个人二维码、手机、邮箱、企业邮箱、地址。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/auth/getuserdetail' \
--header 'Content-Type: application/json' \
--data-raw '{
   "user_ticket": "USER_TICKET"
}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "userid": "lisi",
    "gender": "1",
    "avatar": "http://shp.qpic.cn/bizmp/xxxxxxxxxxx/0",
    "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vcfc13b01dfs78e981c",
    "mobile": "13800000000",
    "email": "zhangsan@gzdev.com",
    "biz_mail": "zhangsan@qyycs2.wecom.work",
    "address": "广州市海珠区新港中路"
}

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

user_ticket

string

成员票据

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

userid

string

成员UserID

必需

gender

string

必需

性别。0表示未定义，1表示男性，2表示女性。仅在用户同意snsapi_privateinfo授权时返回真实值，否则返回0.

avatar

string

必需

头像url。仅在用户同意snsapi_privateinfo授权时返回

qr_code

string

必需

员工个人二维码（扫描可添加为外部联系人），仅在用户同意snsapi_privateinfo授权时返回

mobile

string

必需

手机，仅在用户同意snsapi_privateinfo授权时返回，第三方应用不可获取

string

必需

邮箱，仅在用户同意snsapi_privateinfo授权时返回，第三方应用不可获取

biz_mail

string

必需

企业邮箱，仅在用户同意snsapi_privateinfo授权时返回，第三方应用不可获取

address

string

必需

仅在用户同意snsapi_privateinfo授权时返回，第三方应用不可获取

修改于 2022-12-01 03:29:06

获取访问用户身份

开始开发