企业内部开发 客户端API 小程序 企业通讯录 wx.qy.getEmail
wx.qy.getEmail
最后更新:2022/08/17
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
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