获取用户二次验证信息 - 接口文档

首页

教程

接口

社区

工具

企业内部开发

企业内部开发服务端API 身份验证二次验证获取用户二次验证信息

获取用户二次验证信息

最后更新：2023/11/14

请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/auth/get_tfa_info?access_token=ACCESS_TOKEN
参数说明：

{
	"code": "CODE"
}

参数	必须	说明
access_token	是	调用接口凭证
code	是	用户进入二次验证页面时，企业微信颁发的code `每次成员授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期`

权限说明：
仅『通讯录同步』或者自建应用可调用，如用自建应用调用，用户需要在二次验证范围和应用可见范围内。
并发限制：
20
返回结果：

{
   "errcode": 0,
   "errmsg": "ok",
   "userid":"USERID",
   "tfa_code": "TFA_CODE",
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
userid	成员UserID。若需要获得用户详情信息，可调用通讯录接口：读取成员。
tfa_code	二次验证授权码，开发者可以调用通过二次验证接口，解锁企业微信终端 `tfa_code有效期五分钟，且只能使用一次。`

出错返回示例：

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

概述

登录二次验证

本节内容