該能力旨在幫助開(kāi)發(fā)者向用戶發(fā)起手機(jī)號(hào)申請(qǐng)，并且必須經(jīng)過(guò)用戶同意后，開(kāi)發(fā)者才可獲得由平臺(tái)驗(yàn)證后的手機(jī)號(hào)，進(jìn)而為用戶提供相應(yīng)服務(wù)。

從基礎(chǔ)庫(kù) 2.21.2 開(kāi)始，對(duì)該能力進(jìn)行了安全升級(jí)，以下是新版本組件使用指南。（舊版本組件目前可以繼續(xù)使用，但建議開(kāi)發(fā)者使用新版本組件，以增強(qiáng)小程序安全性）另外，新版本組件不再需要提前調(diào)用wx.login進(jìn)行登錄。

該能力與手機(jī)號(hào)實(shí)時(shí)驗(yàn)證組件的區(qū)別為：

1. 手機(jī)號(hào)快速驗(yàn)證組件，平臺(tái)會(huì)對(duì)號(hào)碼進(jìn)行驗(yàn)證，但不保證是實(shí)時(shí)驗(yàn)證；
2. 手機(jī)號(hào)實(shí)時(shí)驗(yàn)證組件，在每次請(qǐng)求時(shí)，平臺(tái)均會(huì)對(duì)用戶選擇的手機(jī)號(hào)進(jìn)行實(shí)時(shí)驗(yàn)證。

請(qǐng)注意：

1. 目前該接口針對(duì)非個(gè)人開(kāi)發(fā)者，且完成了認(rèn)證的小程序開(kāi)放（不包含海外主體）；
2. 該能力使用時(shí)，用戶可選擇綁定號(hào)碼，或自主添加號(hào)碼。平臺(tái)會(huì)基于中國(guó)三大運(yùn)營(yíng)商提供的短信等底層能力對(duì)號(hào)碼進(jìn)行驗(yàn)證，但不保證是實(shí)時(shí)驗(yàn)證；
3. 請(qǐng)開(kāi)發(fā)者根據(jù)業(yè)務(wù)場(chǎng)景需要自行判斷并選擇是否使用，必要時(shí)可考慮增加其他安全驗(yàn)證手段。
4. 開(kāi)發(fā)者需合理使用，若被發(fā)現(xiàn)或用戶舉報(bào)開(kāi)發(fā)者不合理地要求用戶提供手機(jī)號(hào)等個(gè)人信息，中斷了正常的使用流程，影響了用戶的使用體驗(yàn)，微信有權(quán)依據(jù)《微信小程序平臺(tái)運(yùn)營(yíng)管理規(guī)范》對(duì)該小程序進(jìn)行處理。常見(jiàn)違規(guī)事例和具體解析；

收費(fèi)說(shuō)明

自2023年8月26日起，手機(jī)號(hào)快速驗(yàn)證組件將需要付費(fèi)使用。標(biāo)準(zhǔn)單價(jià)為：每次組件調(diào)用成功，收費(fèi)0.03元。更多套餐價(jià)格請(qǐng)見(jiàn)微信公眾平臺(tái)-付費(fèi)管理。 購(gòu)買操作指引。

請(qǐng)注意：

1. 體驗(yàn)額度：每個(gè)小程序帳號(hào)將有1000次體驗(yàn)額度，用于開(kāi)發(fā)、調(diào)試和體驗(yàn)。該1000次的體驗(yàn)額度為正式版、體驗(yàn)版和開(kāi)發(fā)版小程序共用，超額后，體驗(yàn)版和開(kāi)發(fā)版小程序調(diào)用同正式版小程序一樣，均收費(fèi)；
2. 免費(fèi)規(guī)則：帳號(hào)微信認(rèn)證類型為政府、非營(yíng)利組織的小程序使用此能力不收費(fèi)；帳號(hào)微信認(rèn)證類型為事業(yè)單位，且類目為政務(wù)民生的小程序，亦不收費(fèi)（微信認(rèn)證指引）。

使用方法

需要將 button 組件 open-type 的值設(shè)置為 getPhoneNumber，當(dāng)用戶點(diǎn)擊并同意之后，可以通過(guò) bindgetphonenumber 事件回調(diào)獲取到動(dòng)態(tài)令牌code，然后把code傳到開(kāi)發(fā)者后臺(tái)，并在開(kāi)發(fā)者后臺(tái)調(diào)用微信后臺(tái)提供的 phonenumber.getPhoneNumber 接口，消費(fèi)code來(lái)?yè)Q取用戶手機(jī)號(hào)。每個(gè)code有效期為5分鐘，且只能消費(fèi)一次。

注：getPhoneNumber 返回的 code 與 wx.login 返回的 code 作用是不一樣的，不能混用。

代碼示例

Page({
  getPhoneNumber (e) {
    console.log(e.detail.code)
  }
})

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