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

隨著移動(dòng)互聯(lián)網(wǎng)的快速發(fā)展，小程序已成為許多企業(yè)開(kāi)展業(yè)務(wù)的一種重要形式。在小程序中獲取用戶(hù)信息是很常見(jiàn)的操作，而 wx.getUserInfo(OBJECT) API 就提供了方便的解決方案。

1. wx.getUserInfo(OBJECT) 簡(jiǎn)介

wx.getUserInfo(OBJECT) 是微信小程序提供的獲取用戶(hù)信息的 API 接口，可以獲取用戶(hù)公開(kāi)信息（昵稱(chēng)、頭像等），也可以獲取敏感信息，如unionID等。

2. OBJECT參數(shù)說(shuō)明

在使用 wx.getUserInfo(OBJECT) 時(shí)，需要注意以下參數(shù)：

1. withCredentials：Boolean類(lèi)型，是否帶上登錄態(tài)信息，可選參數(shù)。
2. lang：String類(lèi)型，指定返回用戶(hù)信息的語(yǔ)言，可選參數(shù)。
3. success：Function類(lèi)型，接口調(diào)用成功的回調(diào)函數(shù)，可選參數(shù)。
4. fail：Function類(lèi)型，接口調(diào)用失敗的回調(diào)函數(shù)，可選參數(shù)。
5. complete：Function類(lèi)型，接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行），可選參數(shù)。

3. success 返回參數(shù)說(shuō)明

在調(diào)用 wx.getUserInfo(OBJECT) 的 success 回調(diào)函數(shù)中，會(huì)返回以下參數(shù)：

1. userInfo：OBJECT，用戶(hù)信息對(duì)象，不包含 openid 等敏感信息。
2. rawData：String，不包括敏感信息的原始數(shù)據(jù)字符串，用于計(jì)算簽名。
3. signature：String，使用 sha1(rawData + sessionkey) 得到字符串，用于校驗(yàn)用戶(hù)信息，參考文檔 signature。
4. encryptedData：String，包括敏感數(shù)據(jù)在內(nèi)的完整用戶(hù)信息的加密數(shù)據(jù)，詳細(xì)見(jiàn)加密數(shù)據(jù)解密算法。
5. iv：String，加密算法的初始向量，詳細(xì)見(jiàn)加密數(shù)據(jù)解密算法。

4. UnionID 機(jī)制說(shuō)明

在小程序中，如果開(kāi)發(fā)者擁有多個(gè)移動(dòng)應(yīng)用、網(wǎng)站應(yīng)用或公眾號(hào)（包括小程序），可通過(guò)UnionID來(lái)區(qū)分用戶(hù)的唯一性。同一個(gè)微信開(kāi)放平臺(tái)下的相同主體的App、公眾號(hào)、小程序，如果用戶(hù)已經(jīng)關(guān)注公眾號(hào)，或曾經(jīng)登錄過(guò)App或公眾號(hào)，則用戶(hù)打開(kāi)小程序時(shí)，開(kāi)發(fā)者可以直接通過(guò)wx.login獲取到該用戶(hù)UnionID，無(wú)須用戶(hù)再次授權(quán)。

5. 總結(jié)

在微信小程序中，wx.getUserInfo(OBJECT) API 是獲取用戶(hù)信息的常用方式，通過(guò)該接口可以獲取用戶(hù)公開(kāi)信息和敏感信息（如UnionID），幫助企業(yè)更好地開(kāi)展業(yè)務(wù)。此外，對(duì)于開(kāi)發(fā)者來(lái)說(shuō)，理解UnionID機(jī)制也是很重要的一點(diǎn)。

<本文由himall原創(chuàng)，商業(yè)轉(zhuǎn)載請(qǐng)聯(lián)系作者獲得授權(quán)，非商業(yè)轉(zhuǎn)載請(qǐng)標(biāo)明：himall原創(chuàng)>