该接口涉及 scope 在用户点击授权，开发者获取到 code 调用 /oauth/access_token/ 接口时，/oauth/access_token/ 接口返回的 scope 参数中将不再包含该 scope，开发者仍可以使用该 access_token 调用原有需要用户授权的创建粉丝群接口。授权用户可以在设置-账号与安全-授权管理-经营授权中查看 / 取消已授权的建群能力。抖音开放平台将于近期补齐 access_token 返回相关 scope 的能力。

使用限制

无

接口说明

无

基本信息

名称	描述
HTTP URL	https://open.douyin.com/im/group/count/
HTTP Method	GET
Scope	im.group_fans.create_list
权限要求	新能力上线能力实验室后，经营者可在“控制台-能力管理-能力实验室”中申请。后期能力若转为正式开放能力，可在“控制台-能力管理-互动权限”中申请

请求头

名称	类型	必填	描述
content-type	string	是	固定值 "application/json"
access-token	string	是	调用 /oauth/access_token/ 生成的 token，此 token 需要用户授权。示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy

Query

名称	类型	是否必填	描述	示例
open_id	string	true	调用/oauth/access_token/ 获取，用户唯一标志	ba253642-0590-40bc-9bdf-9a1334b94059

请求示例

curl -X GET 'https://open.douyin.com/im/group/count/?open_id=123-456-890'\
-H 'Content-Type:application/json' \
-H 'access-token:act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWot'

响应参数

名称		类型	描述	示例
extra		struct
	description	string	错误码描述	""
	error_code	int	错误码	0
	logid	string	请求的唯一标识	202008121419360101980821035705926A
	now	int	毫秒级时间戳	1597213176393
	sub_description	string	子错误码描述	""
	sub_error_code	int	子错误码	0
data		struct
	error_code	int	错误码	0
	description	string	错误码描述	""
left_count		int	剩余建群数	10

正常示例

{
  "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": "参数不合法"
  }
}

查询用户剩余建群额度在线调试