抖音开放平台Logo
控制台

tt.checkFollowAwemeState
收藏
我的收藏

​基础库 1.67.0 开始支持本方法，这是一个异步方法。​
提供从小程序查看抖音号是否关注的能力。仅抖音 \ 抖音 Lite \ 抖音火山版支持。​
使用该功能前开发者需要去开发者后台为对应的抖音号申请 查看抖音号关注状态能力，具体信息请参考关注抖音号能力接入指南。目前该接口仅对白名单小程序开放，如需使用，开发者需要至控制台-小程序页面下，进入“能力-用户数据能力-抖音账号数据”，申请检查用户粉丝关系能力。​

​语法​

text
复制
tt.checkFollowAwemeState(options)

​参数说明​

options 为 object 类型，属性如下：​
属性名​
类型​
默认值​
必填​
说明​
最低支持版本​
awemeId​
string​
​
是​
查看关注状态的抖音号​
2.92.0​
success​
function​
--​
否​
接口调用成功后的回调函数​
1.67.0​
fail​
function​
--​
否​
接口调用失败后的回调函数​
1.67.0​
complete​
function​
--​
否​
接口调用结束后的回调函数（调用成功、失败都会执行）​
1.67.0​

​回调成功​

object 类型，属性如下：​
属性名​
类型​
说明​
最低支持版本​
errMsg​
string​
"checkFollowAwemeState:ok"​
1.67.0​
hasFollowed​
boolean​
是否关注抖音号​
1.67.0​

​回调失败​

object 类型，属性如下：​
属性名​
类型​
说明​
最低支持版本​
errMsg​
string​
"checkFollowAwemeState:fail" + 详细错误信息​
1.67.0​

​错误说明​

errNo​
errMsg​
说明​
最低支持版本​
21103​
followAwemeUser:fail awemeId not exist​
抖音号不存在​
2.92.0​
21104​
followAwemeUser:fail awemeId not support​
抖音号没有在开发者后台申请 查看抖音号关注状态 能力。​
2.92.0​

​扫码体验​

​代码示例​

开发者工具中预览​
​

​Bug & Tip​

​Tip：使用该功能前，开发者需要去开发者后台-设置-关联设置-抖音号管理为对应的抖音号申请查看抖音号关注状态能力。​
​