tt.getUserInfo

2020-02-15 01:48 更新

獲取已登錄用戶的基本信息或特殊信息

提示
本 API 需要用戶授權(quán)方可調(diào)用,詳細(xì)信息可參考用戶授權(quán)
本 API 依賴(lài)于 login,請(qǐng)確保調(diào)用前已經(jīng)調(diào)用了該 API


輸入

object 類(lèi)型,屬性如下:

屬性類(lèi)型默認(rèn)值必填說(shuō)明最低支持版本
successfunction接口調(diào)用成功的回調(diào)函數(shù)1.0.0
completefunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)1.0.0
failfunction接口調(diào)用失敗的回調(diào)函數(shù)1.0.0
withCredentialsbooleanfalse是否需要返回敏感數(shù)據(jù)1.0.0

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

object 類(lèi)型,屬性如下:

屬性類(lèi)型說(shuō)明
userInfoobject用戶信息
userInfo.avatarUrlstring用戶頭像
userInfo.nickNamestring用戶名
userInfo.gendernumber用戶性別,0: 未知;1:男性;2:女性
userInfo.citystring用戶城市
userInfo.provincestring用戶省份
userInfo.countrystring用戶國(guó)家
userInfo.languagestring用戶語(yǔ)言,目前為空
rawDatastringuserInfo 的 JSON 字符串形式

如果輸入中傳遞了 withCredentials:true,返回對(duì)象參數(shù)會(huì)增加如下擴(kuò)展屬性:

屬性類(lèi)型說(shuō)明
signaturestring用于校驗(yàn)用戶信息是否被篡改,請(qǐng)參考文檔
encryptedDatastring包括敏感信息(如 openId)在內(nèi)的已加密用戶數(shù)據(jù),如需解密數(shù)據(jù)請(qǐng)參考文檔
ivstring加密算法參數(shù)

encryptedData 解密后可以獲得:

屬性類(lèi)型說(shuō)明
watermarkobject敏感數(shù)據(jù)水印
watermark.appidstring數(shù)據(jù)源小程序 id
watermark.timestampnumber時(shí)間戳,可以用于檢查數(shù)據(jù)的時(shí)效性


代碼示例

tt.getUserInfo({
  success(res) {
    console.log(`getUserInfo 調(diào)用成功 ${res.userInfo}`);
  },
  fail(res) {
    console.log(`getUserInfo 調(diào)用失敗`);
  }
});
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)