抖音开放平台Logo
开发者文档
小程序
控制台
  • JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 登录
  • 用户信息
  • 广告
  • 支付
  • 分享
  • 小程序跳转
  • 抖音视频能力
  • 收货地址
  • 设置
  • 授权
  • 评价能力
  • 数据分析
  • 视频拍摄器
  • 引导关注
  • tt.followOfficialAccount
  • tt.openAwemeUserProfile
  • tt.checkFollowState
  • tt.followAwemeUser
  • tt.checkFollowAwemeState
  • 订阅消息
  • 电商插件能力（即将废弃）
  • AI/AR能力
  • 转发和挂载
  • 直播能力
  • 流量来源识别
  • 侧边栏能力
  • 隐私信息授权
  • web化
  • 行业开放
  • 第三方平台
  • 其它

    • tt.followAwemeUser
    收藏
    我的收藏

    注意：为了更好的保护小程序内的用户体验，平台将于2024年10月22日起 陆续对 tt.followAwemeUser 增加触发频次的限制，以避免频繁弹窗对用户造成骚扰。请开发者提前对能力调用进行自查和调整，确保小程序业务逻辑稳定查看公告
    ​

    基础库 2.19.0 开始支持本方法，这是一个异步方法。

    调用此 API 会弹出弹框，用户可以点击按钮关注绑定的抖音号。仅抖音 \ 抖音 Lite \ 抖音火山版支持。

    使用该功能前开发者需要去开发者后台为对应的抖音号申请关注抖音号接口能力，具体信息请参考关注抖音号能力接入指南。

    前提条件无
    业务背景无
    使用限制无
    注意事项
    • Tip： 使用该功能前开发者需要去开发者后台-设置-关联设置-抖音号管理为对应的抖音号申请 关注抖音号接口能力；
    • Tip： 抖音号没有关注抖音号接口权限，会触发 fail 回调，对应的错误码是 21103 。
    支持沙盒
    否
    相关教程无

    语法

    tt.followAwemeUser(options)

    参数说明

    options 为 object 类型，属性如下：

    属性名类型默认值必填说明最低支持版本
    awemeIdstring否
    引导关注的抖音号
    		2.92.0
    successfunction否
    接口调用成功的回调函数
    		2.19.0
    failfunction否
    接口调用失败的回调函数
    		2.19.0
    completefunction否
    接口调用结束的回调函数（调用成功、失败都会执行）
    		2.19.0

    回调成功

    object 类型，属性如下：

    属性名类型说明最低支持版本
    followedboolean
    返回调用此 API 之前是否已关注抖音号
    		2.19.0
    errMsgstring
    "followAwemeUser:ok"
    		2.19.0

    回调失败

    object 类型，属性如下：

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

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    106502followAwemeUser:fail previous API call not finished yetD
    连续调用

    当前已有关注弹窗，等待前序api返回

    		2.19.0
    106502${METHOD_NAME}:fail ${res?.data?.err_msg ?? 'server error'}F
    小程序框架内部错误，有需要请创建工单咨询
    		2.19.0
    106595followAwemeUser:fail cancelU
    用户取消

    用户取消，不需要特殊处理

    		2.19.0
    106505followAwemeUser:fail awemeId not supportD
    抖音号未绑定bc

    检查抖音号bc关系

    		2.19.0
    106501followAwemeUser:fail aweme uid is nullD
    未传入抖音号也未绑唯一普通抖音号

    传入绑定bc关系的抖音号

    		2.19.0
    106503followAwemeUser:fail following request failedF
    小程序框架内部错误，有需要请创建工单咨询
    		2.19.0
    106599followAwemeUser:fail params.xxx should be xxx, but got xxxD
    错误入参

    检查入参

    		2.19.0
    106596followAwemeUser:fail not loginD
    开发者错误，开发者可以通过调用tt.login帮助用户登录

    用户未登录，可通过调用 tt.login 帮助用户登录

    		2.19.0
    106591followAwemeUser:fail Internal error: xxxF
    小程序框架内部错误，有需要请创建工单咨询
    		2.19.0
    106504followAwemeUser:fail awemeId not existD
    传入不存在的抖音号

    检查抖音号

    		2.19.0
    106504followAwemeUser:fail awemeId not existD
    传入不存在的抖音号

    检查抖音号

    		2.19.0
    106585followAwemeUser:fail network unavailableU
    用户错误

    用户网络不佳，若此错误频繁出现建议加入超时重试逻辑

    		2.19.0
    106506followAwemeUser:fail popup reaches limitD
    当日弹出次数已超限

    当日弹出次数达限，隔日再试

    		2.19.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    ​