在企业微信的应用开发中, 对于安全要求高的第三方应用,需要对企业成员进行验证。 开启二次验证后, 当且仅当成员登录时, 需要跳转至企业自定义的页面进行验证。验证频率可在设置页面选择。
上章我们说了开启二次验证的方法, 本章我们主要说下, 二次验证的接口调用方式
二次验证
请求方式:GET(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/user/authsucc?access_token=ACCESS_TOKEN&userid=USERID
参数说明:
[C#] 纯文本查看 复制代码
参数 必须 说明
1. access_token 是 调用接口凭证
2. userid 是 成员UserID。对应管理端的帐号
返回结果:
[C#] 纯文本查看 复制代码
{
"errcode": 0,
"errmsg": "ok"
}
返回结果参数说明:
[C#] 纯文本查看 复制代码
参数 说明
1. errcode 返回码
2. errmsg 对返回码的文本描述内容
企业在开启二次验证时,必须在管理端填写企业二次验证页面的url。
当成员登录企业微信或关注微工作台(原企业号)进入企业时,会自动跳转到企业的验证页面。在跳转到企业的验证页面时,会带上如下参数:code=CODE。
企业收到code后,使用“通讯录同步助手”调用接口“根据code获取成员信息”获取成员的userid。
如果成员是首次加入企业,企业获取到userid,并验证了成员信息后,调用如下接口即可让成员成功加入企业。
|