2023年微信小程序API 用户信息 wx.getUserInfo(OBJECT)

随着移动互联网的快速发展，小程序已成为许多企业开展业务的一种重要形式。在小程序中获取用户信息是很常见的操作，而 wx.getUserInfo(OBJECT) API 就提供了方便的解决方案。

1. wx.getUserInfo(OBJECT) 简介

wx.getUserInfo(OBJECT) 是微信小程序提供的获取用户信息的 API 接口，可以获取用户公开信息（昵称、头像等），也可以获取敏感信息，如unionID等。

2. OBJECT参数说明

在使用 wx.getUserInfo(OBJECT) 时，需要注意以下参数：

1. withCredentials：Boolean类型，是否带上登录态信息，可选参数。
2. lang：String类型，指定返回用户信息的语言，可选参数。
3. success：Function类型，接口调用成功的回调函数，可选参数。
4. fail：Function类型，接口调用失败的回调函数，可选参数。
5. complete：Function类型，接口调用结束的回调函数（调用成功、失败都会执行），可选参数。

3. success 返回参数说明

在调用 wx.getUserInfo(OBJECT) 的 success 回调函数中，会返回以下参数：

1. userInfo：OBJECT，用户信息对象，不包含 openid 等敏感信息。
2. rawData：String，不包括敏感信息的原始数据字符串，用于计算签名。
3. signature：String，使用 sha1(rawData + sessionkey) 得到字符串，用于校验用户信息，参考文档 signature。
4. encryptedData：String，包括敏感数据在内的完整用户信息的加密数据，详细见加密数据解密算法。
5. iv：String，加密算法的初始向量，详细见加密数据解密算法。

4. UnionID 机制说明

在小程序中，如果开发者拥有多个移动应用、网站应用或公众号（包括小程序），可通过UnionID来区分用户的唯一性。同一个微信开放平台下的相同主体的App、公众号、小程序，如果用户已经关注公众号，或曾经登录过App或公众号，则用户打开小程序时，开发者可以直接通过wx.login获取到该用户UnionID，无须用户再次授权。

5. 总结

在微信小程序中，wx.getUserInfo(OBJECT) API 是获取用户信息的常用方式，通过该接口可以获取用户公开信息和敏感信息（如UnionID），帮助企业更好地开展业务。此外，对于开发者来说，理解UnionID机制也是很重要的一点。