查询群主所在群的用户入群申请状态

该接口用于查询群主所在群下的所有用户的申请进群信息

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

使用限制

该接口会过滤掉所有非申请中状态的申请单，可能会出现has_more和实际列表数量不一致的返回值

接口说明

当前开放用户范围：小程序品牌号及员工号和认证企业号及其员工号；后续将基于抖音经营者实际诉求逐步拓展开放用户范围。

权限要求
小程序通过平台试运营期后默认获得的能力。注：关于小程序试运营期介绍详情请查看小程序试运营说明。
需要用户授权

curl --location --request GET 'http://dev-cn.your-api-server.com/im/group/enter/audit/get/?open_id=ba253642-0590-40bc-9bdf-9a1334b94059&cursor=0&count=10' \ --header 'access-token: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWot' \ --header 'Content-Type: application/json' \ --data-raw ''

{ "apply_list": { "cursor": 1, "has_more": false, "list": [ { "apply_id": "@9VwNxuKKBZ03MXG7M8ooWM7912XrPPqCOJdzqQ6lL1kVbfX760zdRmYqig357zEB84GwkVBjbo2eCWCq4V****==", "apply_status": 1, "create_time": 1676874310259, "group_id": "@9VwNxuKKBZ03MXG7M8ooWM7912XrPPmLO5dyrAOnK1UTZ/T/60zdRmYqig357zEBdsFiI4euKz5E1pivD****==", "user_id": "29d2f583-7fd6-4daa-b1d4-cfab5c05079Q" } ] }, "data": { "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20230222103211977B5DF3F5230D43A615", "now": 1677033132 }

请求参数

Query 参数

open_id

string

用户openid

必需

示例值:

ba253642-0590-40bc-9bdf-9a1334b94059

cursor

string

必需

每页的数量，最大不超过50，最小不低于1

示例值:

count

string

可选

分页游标, 第一页请求cursor是0, response中会返回下一页请求用到的cursor, 同时response还会返回has_more来表明是否有更多的数据

示例值:

Header 参数

Content-Type

string

必需

示例值:

application/json

access-token

string

必需

调用 /oauth/access_token/ 生成的 token，此 token 需要用户授权。示例：act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy

示例值:

act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWot

返回响应

🟢200成功

application/json

Body

apply_list

object

必需

cursor

integer

必需

has_more

boolean

必需

list

array [object {5}]

必需

data

object

必需

error_code

integer

错误码

必需

description

string

错误码描述

必需

extra

object

必需

error_code

integer

错误码

必需

description

string

错误码描述

必需

sub_error_code

integer

子错误码

必需

sub_description

string

子错误码描述

必需

logid

string

请求的唯一标识

必需

now

integer

毫秒级时间戳

必需

🟠400请求有误

查询群主所在群的用户入群申请状态

使用限制#

接口说明#

请求参数

返回响应

使用限制

接口说明