抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 登录
  • 社交转发裂变
  • 用户信息及授权
  • 设置
  • 用户信息
  • tt.getUserInfo
  • tt.authenticateRealName
  • tt.onRealNameAuthenticationComplete
  • 敏感数据处理
  • 授权
  • 小游戏收藏
  • 群聊
  • 关注
  • 游戏互推组件
  • 添加到桌面
  • 游戏排行榜
  • 数据分析
  • 视频拍摄器
  • 订阅消息
  • 关系链
  • 客服能力
  • 侧边栏能力
  • 推荐流直出游戏能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • Worker
  • 基础库 1.80.0 开始支持本方法,这是一个异步方法。

    拉起实名认证窗口。

    前提条件
    调用该接口前请确保用户已登录。
    业务背景
    使用限制
    注意事项

    当前用户是否已经实名认证可以通过 tt.getUserInfo 查询

    相关教程

    语法

    tt.authenticateRealName(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    successfunction
    接口调用成功的回调函数
    1.80.0
    failfunction
    接口调用失败的回调函数
    1.80.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    1.80.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "authenticateRealName:ok"
    1.80.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "authenticateRealName:fail" + 详细错误信息
    1.80.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    999992empty aid or appIdF
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    999996no user loginD
    1.80.0
    999990user rejectU
    1.80.0
    999976no user tap actionD
    1.80.0
    999985network errorU
    1.80.0
    108401user already verifiedU
    1.80.0
    108402real name auth service fail %sF
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    999991internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    108403real name auth data invalidF
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    999993internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    999991no platform supportF
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    999996not loginD
    1.80.0
    999991Internal error: service error xxx(serverCode) identityF
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    999985network unavailableU
    1.80.0
    999993internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    开发者工具中预览

    tt.login({ force: true, success() { console.log("登录成功"); //实名认证需要用户点击触发 tt.onTouchEnd(realNameAuth); }, }); function realNameAuth() { tt.authenticateRealName({ success(_res) { console.log("用户实名认证成功"); }, fail(res) { console.log("用户实名认证失败", res.errMsg); }, }); }