微信小程序企业微信兼容— wx.qy.getEnterpriseUserInfo(Object object)

微信小程序企业微信兼容— wx.qy.getEnterpriseUserInfo(Object object)

# wx.qy.getEnterpriseUserInfo(Object object)

调用前提:
1、必须先调用过wx.qy.login,且session_key未过期,开发者可调用checkSession 检查当前登录态。
2、用户在应用可见范围内时可以静默获取,否则需要用户同意确认。

获取企业成员基本信息

# 参数

# Object object
参数名 类型 必填 说明
timeout Number 超时时间,单位 ms
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)
# object.success 回调函数

参数

Object res

参数 类型 说明
userInfo OBJECT 用户信息对象,不包含userid、手机号、头像等敏感信息
rawData String 不包括敏感信息的原始数据字符串,用于计算签名。
signature String 使用 sha1( rawData + sessionkey ) 得到字符串,用于校验用户信息,参考文档 signature
encryptedData String 包括敏感数据在内的完整用户信息的加密数据,详细见加密数据解密算法
iv String 加密算法的初始向量,详细见加密数据解密算法

userInfo参数说明:

参数 类型 说明
name String 企业成员姓名
gender Number 企业成员的性别,0表示未定义,1表示男性,2表示女性
language String 用户的语言,简体中文为zh_CN

示例代码:

wx.qy.getEnterpriseUserInfo ({
  success: function(res) {
    var userInfo = res.userInfo
    var name = userInfo.name
    var gender = userInfo.gender //性别 0:未知、1:男、2:女
  }
})

encryptedData 解密后为以下 json 结构,详见加密数据解密算法, 注意解密时使用的appid为小程序的appid,而非企业的corpid,后不再赘述。

{
    "corpid": "CORPID",
    "userid": "USERID",
    "name": "NAME",
    "gender": GENDER,
    "watermark":
    {
        "appid":"APPID",
        "timestamp":TIMESTAMP
    }
}

encryptedData解密后json参数说明:

参数 类型 说明
corpid String 用户所属企业的corpid
userid String 企业成员UserID,对应管理端的帐号。注意:如果该企业没有关联该小程序,则此处返回加密的userid
name String 企业成员姓名
gender Number 企业成员的性别,0表示未定义,1表示男性,2表示女性
watermark 数据水印,应用可以依此校验数据的有效性
watermark::appid String 敏感数据归属的小程序appid,开发者可校验此参数与自身appid是否一致,注意此appid不是企业微信的corpid
watermark::timestamp DateInt 敏感数据获取的时间戳, 开发者可以用于数据时效性校验