粉丝判断
收藏开发者应用下授权的抖音账号可根据其他用户的 open_id 判断其是否关注了当前抖音账号，即为当前抖音账号的粉丝。
状态码排查
接口说明
粉丝判断通过用户 B 的 open_id（follower_open_id）和用户 A 的 open_id 的关系来判断用户 B 是否关注了用户 A。
- 如果响应参数 is_follower 为 true，则用户 B 关注了用户 A。
- 如果响应参数 is_follower 为 false，则用户 B 未关注用户 A。
- 需要双方账号为公开账号，且粉丝和关注列表都是公开的状态。
- 账号为封禁、注销、私密、关注/粉丝列表私密、在他人关注/粉丝列表私密等状态时，认为是非公开态。
基本信息
请求参数
请求头
access-token必填String
示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Query
follower_open_id必填String
示例：ba253642-0590-40bc-9bdf-9a1334b94059
目标粉丝用户的 open_id。
open_id必填String
示例：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展开全部子属性
dataStruct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "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 } }
错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100005 | "参数不合法" | 检查入参合法性 |
| 200 | 2190015 | “请求参数 access_token openid 不匹配” | 被关注者的id非法 |
| 200 | 2100004 | “系统繁忙，此时请开发者稍候再试” | 请重试 |
| 200 | 2100007 | “无权限操作” | 无法判断私密用户的关注关系，参数中存在账号为非公开态。
|
