该能力旨在帮助开发者向用户发起手机号申请，并且必须经过用户同意后，开发者才可获得由平台验证后的手机号，进而为用户提供相应服务。

小程序端手机号授权

使用方法

步骤 1：配置 button 组件

需要将 button 组件的 open-type 值设置为 getPhoneNumber，当用户点击并同意授权后，通过 bindgetphonenumber 事件获取回调信息。

步骤 2：处理回调数据

将 bindgetphonenumber 事件回调中的动态令牌 code 传到开发者后台，并调用 bilibili 后台提供的 phonenumber.getPhoneNumber 接口，消费该 code 来换取用户手机号。
注意：每个 code 有效期为 5 分钟，且只能消费一次。

⚠️ 重要提示：
getPhoneNumber 返回的 code 与 bl.login 返回的 code 作用不同，不可混用。

代码示例

XML 部分

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

JS 部分

Page({
  getPhoneNumber(e) {
    console.log(e.detail.code); // 动态令牌
    console.log(e.detail.errMsg); // 回调信息（无论成功/失败均返回）
    console.log(e.detail.errno); // 错误码（仅失败时返回）

    // 实际开发中需将 code 发送到开发者后台处理
    // bl.request({
    //   url: 'https://your-backend-api.com/phone',
    //   data: { code: e.detail.code }
    // })
  },
});

返回参数说明

服务端手机号授权

1 接口说明

该接口用于小程序手机号授权登录，获取用户手机号。

2 请求说明

2.1 基础信息

2.2 请求参数

3 响应说明

3.1 响应信息

3.2 错误码

备注：后续有新增或者变化，会持续新增

3.3 完整示例

3.3.1 请求示例

URL：
{API}?access_key=b6dj2f1e785149fjp2dedbiad68dwl9y&ts=1736739534331&sign=WbGNoWSnhogpKzilnQfPciPYdJgiTc2w6T2BI7Bcpo4B

Body:

{
  "app_id": "bili4a144dc9519e38b8",
  "open_id": "fba20827e95da8ada251be6bab2bb679",
  "preauth_code": "PRE_AUTH_1741958522488_fe11657247b54a75a855a4d9a6d38cb6"
}

3.3.2 响应示例

{
  "data": {
    "encrypted_phone": "uXkJiU7eAHbDcHKLTrbJ4Q==",
    "iv": "$YOCLvODjA7PbkQB"
  },
  "code": 0,
  "message": "success",
  "current_time": 1739871452085
}

4 解密说明

接口返回的手机号信息是经过AES加密的，需要使用以下方式进行解密：

4.1 加密算法

• 算法：AES
• 模式：CBC
• 填充：PKCS5PADDING
• 密钥：由B站小程序团队提供的secretKey
• 初始化向量：接口返回的iv字段

4.2 解密步骤

1. 使用Base64解码encrypted_phone字段
2. 使用提供的secretKey和iv进行AES解密
3. 解密后得到明文手机号

4.3 代码示例

public class AESDecryptor {
    public static String decrypt(String encryptedData, String secretKey, String iv) throws Exception {
        SecretKeySpec keySpec = new SecretKeySpec(secretKey.getBytes(), "AES");
        IvParameterSpec ivSpec = new IvParameterSpec(iv.getBytes());
        Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5PADDING");
        cipher.init(Cipher.DECRYPT_MODE, keySpec, ivSpec);
        byte[] decodedEncryptedData = Base64.getDecoder().decode(encryptedData);
        byte[] original = cipher.doFinal(decodedEncryptedData);
        return new String(original);
    }

    public static void main(String[] args) {
        try {
            String encryptedData = "加密手机号";
            String secretKey = "B站小程序团队获取";
            String iv = "接口返回";
            String decryptedData = decrypt(encryptedData, secretKey, iv);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

5 版本变更