服务商代开发
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
服务商代开发
客户端API
小程序
企业通讯录
wx.qy.getEmail
wx.qy.getEmail
最后更新:2022/08/17

wx.qy.getEmail(Object object)

调用前提:
1、必须先调用过wx.qy.login,且session_key未过期,开发者可调用checkSession 检查当前登录态
2、要求用户在应用可见范围内,且每次调用都需要用户同意确认
3、仅自建应用可调用,代开发应用需要管理员勾选授权了邮箱,第三方应用不可调用

获取企业成员邮箱地址

参数

Object object
参数名类型必填说明
timeoutNumber超时时间,单位 ms
successFunction接口调用成功的回调函数
failFunction接口调用失败的回调函数
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

 

object.success 回调函数

参数

Object res

参数类型说明
encryptedDataString包括敏感数据在内的完整用户信息的加密数据,详细见加密数据解密算法
ivString加密算法的初始向量,详细见加密数据解密算法

示例代码:

wx.qy.getEmail ({
  success: function(res) {
    console.log(res.encryptedData)
    console.log(res.iv)
  }
})

encryptedData 解密后为以下 json 结构,详见加密数据解密算法

{
    "email": "EMAIL",
    "watermark":
    {
        "appid":"APPID",
        "timestamp":TIMESTAMP
    }
}

encryptedData解密后json参数说明:

参数类型说明
emailString当前企业成员的邮箱地址
watermark数据水印,应用可以依此校验数据的有效性
watermark::appidString敏感数据归属的小程序appid,开发者可校验此参数与自身appid是否一致,注意此appid不是企业微信的corpid
watermark::timestampDateInt敏感数据获取的时间戳, 开发者可以用于数据时效性校验
上一篇wx.qy.getMobile
下一篇wx.qy.selectCorpGroupContact
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们