此接口用于员工使用企业QQ授权后安全退出;一个典型的应用场景为:当第三方网站实现了“使用企业QQ登录”的功能,在授权成功以后会在用户浏览器种上企业QQ的登录态便于员工下次自动登录,如果员工想安全退出,需要调用此接口清除企业QQ的登录态。
当前API提供的是javascript接口,需要
1. 在页面中合适的位置引入如下js: http://combo.b.qq.com/account/openAPI/js/httpLoginOut.js
如果业务已经支持https, 则相应的要调用如下js: https://combo.b.qq.com/account/openAPI/js/httpsLoginOut.js
2. 调用开放平台注销登录接口 eim_logout.logout(callback); 该接口将会调用开放平台cgi进行登录态的清除操作。在该cgi成功返回之后,callback将被回调。callback会被传入一个参数表示操作的状态,如下:
返回值 | 说明 |
---|---|
2 | 成功 |
其他 | 失败 |
一个典型的调用用例为:
<script type="text/javascript" src="http://combo.b.qq.com/account/openAPI/js/httpLoginOut.js" charset="UTF-8"></script> <script> eim_logout.logout(function(rs) { if (rs === 2) { window.location.href = "logout成功后需要跳转的url"; } else { alert('安全退出失败,请重试'); } }); </script>