获取用户手机号

获取用户在抖音绑定的手机号,适用于注册登录、账户绑定、用户触达等场景
支持的应用类型:小程序、移动应用、网站应用
能力类型:
小程序能力分级:进阶能力
是否可用于沙盒环境:
支持的调用方:自研、服务商代开发

能力介绍

获取用户在抖音绑定的手机号,可用于注册登录、账号绑定、用户触达、业务办理等场景,该能力适用于小程序、移动应用、网站应用,其中小程序支持开发者自行申请及使用能力,也支持服务商代申请及使用能力;移动应用和网站应用仅支持开发者自行操作。

扫码体验在小程序内获取用户手机号,移动应用和网站应用的交互体验类似:

使用场景

可在注册登录、账号绑定、用户触达、票务预订、业务办理、信息查询等需要获取用户手机号的场景下使用,以某二手车小程序为例:该小程序主要用于查看二手车价格等信息,在用户提交购车或询价申请时可获取用户手机号。大致步骤如下:

  1. 打开小程序,选择要咨询的商品;
  2. 点击「立即询底价」,引导用户同意授权手机号;
  3. 在授权弹窗中点击「同意」后,授权并进入下一步;如果用户点击不同意,则获取不到用户手机号。

准入条件

小程序申请该能力的准入条件:

  1. 小程序已上线;
  2. 小程序通过试运营期


移动/网站应用申请该能力的准入条件:

仅限企业、党政事业单位开发者申请。


接入流程

一、小程序接入流程

无需申请,通过试运营期后自动获取


二、移动/网站应用接入流程

步骤

说明

申请能力

登录抖音开放平台,在控制台中选择需要申请能力的应用,进入页面后若满足准入条件可申请开通。

填写信息提交申请

  • 申请每个能力时需填写真实的使用场景;
  • 若开通后,发现开发者在使用过程中滥用此能力,对用户或平台造成负面影响,平台将有权利随时对该能力进行收回,并视情况进行处罚。

平台审核

平台会根据信息填写的完整度及合理性进行审核,审核时间为 5 个工作日。

使用能力

审核通过后即可调用接口使用该能力。

接口列表

应用类型

API名称

API类型

API描述

接口文档

小程序

获取用户手机号

JSAPI

获取用户手机号并对手机号进行解密

查看文档

代申请用户手机号能力

OpenAPI

服务商可通过该接口在首次开发环节,代指定服务类目小程序申请获取用户手机号能力

查看文档

查询能力申请状态

OpenAPI

服务商可通过该接口在首次开发环节,查询指定服务类目小程序能力申请状态

查看文档

移动/网站应用

获取用户授权

Web/JSAPI/Android/iOS

获取用户手机号前需经过用户授权,该接口可显示授权弹窗

查看文档

获取用户手机号

OpenAPI

获取用户手机号并对手机号进行解密

查看文档

该文档是否对你的开发有所帮助?
有帮助
没帮助