抖音开放平台Logo
控制台

粉丝判断

更新时间 2024-07-24 02:58:49
收藏
我的收藏
开发者应用下授权的抖音账号可根据其他用户的 open_id 判断其是否关注了当前抖音账号，即为当前抖音账号的粉丝。​

​状态码排查​

​接入遇到的问题可通过状态码排查工具进行查询。​

接口说明

粉丝判断通过用户 B 的 open_id（follower_open_id）和用户 A 的 open_id 的关系来判断用户 B 是否关注了用户 A。

  • 如果响应参数 is_follower 为 true，则用户 B 关注了用户 A。
  • 如果响应参数 is_follower 为 false，则用户 B 未关注用户 A。
  • 需要双方账号为公开账号，且粉丝和关注列表都是公开的状态。

基本信息

名称描述
HTTP URL
https://open.douyin.com/fans/check/
HTTP Method
GET
Scope
fans.check
权限要求

路径：抖音开放平台控制台 > 应用详情 > 能力管理 > 用户权限 > 粉丝判断

请求头

名称字段类型是否必填示例描述
access-tokenString是act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/access_token/生成的token
content-typeString是application/json
固定值"application/json"

请求参数

Query

名称字段类型是否必填示例描述
follower_open_idString是ba253642-0590-40bc-9bdf-9a1334b94059
目标粉丝用户的 open_id。
open_idString是ba253642-0590-40bc-9bdf-9a1334b94059

通过/oauth/access_token/获取，用户唯一标志。openid必须与access_token的授权用户保持一致

请求示例

curl --location --request GET 'https://open.douyin.com/fans/check/?open_id=ba253642-0590-40bc-9bdf-9a1334b94059&follower_open_id=ba253642-0590-40bc-9bdf-9a1334b94059' \
--header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr' \

响应参数

Body

名称字段类型是否必填示例描述

响应示例

正常响应示例

{
  "extra": {
    "now": 1597213176393,
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "202008121419360101980821035705926A"
  },
  "data": {
    "error_code": 0,
    "description": "",
    "is_follower": true,
    "follow_time": 1571075129
  }
}

异常响应示例

{
  "data": {
    "error_code": 2100005,
    "description": "Parameter error"
  },
  "extra": {
    "error_code": 2100005,
    "description": "Parameter error",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1594015876138,
    "log_id": "2020070614111601022506808001045D59"
  }
}

错误码

http状态码错误码错误码描述排查建议
2002100005
"参数不合法"
检查入参合法性
2002190015
“请求参数 access_token openid 不匹配”
被关注者的id非法
2002100004
“系统繁忙，此时请开发者稍候再试”
请重试
2002100007
“无权限操作”
无法判断私密用户的关注关系
​