• OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 搜索能力
  • 订阅消息
  • 挂载
  • 分发
  • 私信和群聊
  • 群聊管理
  • 粉丝群管理
  • 查询群信息
  • 创建粉丝群
  • 查询用户剩余建群额度
  • 变更用户入群申请状态
  • 查询群主所在群的用户入群申请状态
  • 粉丝群webhook
  • 设置进群问候语&群公告
  • 取消进群问候语&群公告配置
  • 群消息管理
  • 经营工具
  • 私信管理
  • 私域经营常见问题
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
  • 查询用户剩余建群额度

    收藏
    我的收藏
    查询自身为群主的剩余建群额度。

    接口说明

    基本信息

    基本信息
    HTTP URL
    HTTP Method
    GET
    Scope
    im.group_fans.create_list
    权限要求
      小程序通过平台试运营期后默认获得的能力。注:关于小程序试运营期介绍详情请查看小程序试运营说明
      开发者后台-设置-关联设置-抖音号管理为小程序经营者申请粉丝群管理能力

    请求头

    字段
    数据类型
    必填
    说明
    access-token
    string
    通过 BusinessToken 进行调用
    示例:bus_act.3c2f5cc363d5c464e509c066*********oDYf3Fmzl6ztOYr
    Content-Type
    string
    必须包含 application/json

    请求参数

      请求params
    字段
    数据类型
    必填
    说明
    open_id
    string
    经营者唯一标识,可以通过:
      通过控制台-能力-私信和群聊-群聊管理授权用户详情页中获取
      其他OpenID获取方式获取
    示例:ba253642-0590-40bc-9bdf-9a1334b94059

    返回值

      JSON 数据包
    字段
    数据类型
    说明
    left_count
    int
    查询 openid 为群主的创建的粉丝群
    extra
    object
    请求错误信息
    data
    object
    请求错误信息

    返回数据示例

      请求
    curl -X GET 'https://open.douyin.com/im/group/count?open_id=123-456-890'\ -H 'Content-Type:application/json' \ -H 'access-token:act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ec'
      正常示例
    { "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "now": 1666756486, "logid": "2022102611544501014017115714020A20" }, "data": { "error_code": 0, "description": "" }, "left_count": 2 }
      错误示例
    { "extra": { "sub_description": "", "sub_error_code": 0, "description": "参数不合法", "error_code": 2100005, "logid": "202203271807199888808121990491456D", "now": 1648375639 }, "data": { "error_code": 2100005, "description": "参数不合法" } }

    错误码

    进入状态码排查工具进行排查。