查询粉丝群
收藏接口说明
查询自身为群主的粉丝群列表
使用限制
查询的群类型为万粉群或主播粉丝群
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/im/group/fans/list/ |
| HTTP Method | GET |
| Scope | im.group_fans.create_list |
| 权限要求 | 新能力上线能力实验室后，经营者可在“控制台-能 力管理-能力实验室”中申请。后期能力若转为正式开放能力，可在“控制台-能力管理-互动权限”中申请。 小程序私信/群管理 满足任一能力即可 粉丝群管理 满足任一能力即可 |
请求参数
请求头
access-token必填String
示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例：application/json
固定值"application/json"
Query
open_id必填String
示例：ba253642-0590-40bc-9bdf-9a1334b94059
调用 /oauth/access_token/ 生成，用户唯一标识
请求示例
curl -X GET 'https://open.douyin.com/im/group/fans/list/?open_id=123-456-890'\ -H 'Content-Type:application/json' \ -H 'access-token:act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ec'
响应参数
Body展开全部子属性
data必填Struct
展开子属性
group_list必填List
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "description": "", "sub_error_code": 0, "sub_description": "", "now": 1648797449, "logid": "021648797449846fd1b1111000700600000000000000086dfb920", "error_code": 0 }, "data": { "error_code": 0, "description": "" }, "group_list": [ { "exist_num": 1, "group_name": "group_name", "max_num": 500, "description": "description", "entry_limit": null, "group_id": "@aaaaaa==", "status": "Normal", "tags": null, "avatar_uri": "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-001" } ] }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100005 | 参数不合法 | 建议自查参数类型和取值是否符合规范 |
