字節(jié)跳動(dòng)小程序開(kāi)發(fā)組件文檔 獲取手機(jī)號(hào)

獲取用戶(hù)綁定的手機(jī)號(hào)。需要用戶(hù)主動(dòng)通過(guò) button 組件的點(diǎn)擊來(lái)觸發(fā)后才能發(fā)起獲取手機(jī)號(hào)接口。

注意事項(xiàng)

• 請(qǐng)謹(jǐn)慎使用，僅可在登陸時(shí)使用?。?！若用戶(hù)舉報(bào)較多或被發(fā)現(xiàn)在不必要場(chǎng)景下使用，字節(jié)跳動(dòng)有權(quán)永久回收該小程序的該接口權(quán)限。
• 使用（用戶(hù)點(diǎn)擊button）前需先調(diào)用tt.login接口。如果在回調(diào)中調(diào)用 tt.login 會(huì)刷新登錄態(tài)，導(dǎo)致登陸后換取的 sessionKey 與手機(jī)號(hào)碼加密時(shí)使用的 sessionKey 不同，從而導(dǎo)致解密失敗。
• 基礎(chǔ)庫(kù)1.14.0開(kāi)始支持

使用方法

需要將 <button> 組件 open-type 的值設(shè)置為 getPhoneNumber。用戶(hù)點(diǎn)擊后會(huì)彈出一個(gè)授權(quán)彈窗讓用戶(hù)確認(rèn)（若該用戶(hù)賬戶(hù)未綁定手機(jī)號(hào)碼會(huì)執(zhí)行一次綁定手機(jī)號(hào)碼的流程；授權(quán)彈窗每次使用都會(huì)彈出）。 用戶(hù)同意后，開(kāi)發(fā)者可以通過(guò) bindgetphonenumber 事件回調(diào)獲取到一個(gè)加密數(shù)據(jù)，開(kāi)發(fā)者可以把該數(shù)據(jù)傳回到自己的服務(wù)端進(jìn)行解密獲取手機(jī)號(hào)。

代碼示例

<button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumberHandler"></button>

Page({
  getPhoneNumberHandler (e) {
    console.log(e.detail.errMsg)
    console.log(e.detail.iv)
    console.log(e.detail.encryptedData)
  }
});

回調(diào)參數(shù)說(shuō)明

errMsg為發(fā)生錯(cuò)誤時(shí)具體的錯(cuò)誤信息：

• 開(kāi)放平臺(tái)沒(méi)有權(quán)限獲取手機(jī)號(hào)：platform auth deny。若平臺(tái)封禁了某開(kāi)發(fā)者該權(quán)限時(shí)可能返回或者是非企業(yè)小程序也會(huì)返回此信息。
• 未在小程序平臺(tái)登錄：not login。開(kāi)發(fā)者看到此信息后應(yīng)當(dāng)執(zhí)行登錄操作。
• 用戶(hù)沒(méi)有綁定手機(jī)號(hào)或用戶(hù)拒絕授權(quán)：auth deny。
• 其他錯(cuò)誤：internal error。

數(shù)據(jù)解密

參考敏感數(shù)據(jù)處理在開(kāi)發(fā)者后臺(tái)解密。揭秘后獲取得到的數(shù)據(jù)形式如下：

{
  "phoneNumber": "138xxxxxxxx",     // 用戶(hù)綁定的手機(jī)號(hào)（國(guó)外手機(jī)號(hào)會(huì)有區(qū)號(hào)）
  "purePhoneNumber": "138xxxxxxxx", // 沒(méi)有區(qū)號(hào)的手機(jī)號(hào)
  "countryCode": "86",              // 區(qū)號(hào)
  "watermark": {
    "appid": "ttxxxxxxxxxxxxxxxx",
    "timestamp": 15000000000000000
  }
}