按分组获取成员列表

重要提示

该功能为 尊享版 付费功能，如未升级，请先 升级 后再使用

接口概述

• 功能：按分组获取成员列表
• 请求方式：GET
• 请求地址：/api/contacts/teams/{team_id}/groups/{group_id}/users?appid={appid}&access_token={access_token}&page={1}&per_page={10}

请求参数

参数名	类型	必须	参数位置	描述	示例值
team_id	integer	是	uri	团队ID	30
group_id	integer	是	uri	分组ID	30
page	integer	否	queryString	当前页码	1
per_page	integer	否	queryString	每页显示条数	10
roles	array	否	queryString	通讯录管理角色（与团队角色不同）	[1,2,3]

响应参数

参数名	类型	描述
total	integer	总条数
list	array[object]	成员列表
list[_].user_id	integer(uint64)	成员编辑者ID
list[_].respondent_id	integer(uint64)	成员回答者ID
list[_].name	string	成员昵称
list[_].avatar	string	成员头像
list[_].role	integer	通讯录管理角色
list[_].group_full_name	string	所在组完整路径
list[_].group_id	int	所在组ID

响应示例

{    "code": "OK",    "error": {        "type": ""    },    "data": {        "total":1,        "list": [            {                "user_id": 60000208205,                "respondent_id": 60000208206,                "name": "张三",                "avatar": "https://wj.qq.com/xxx/xxx.png",                "role": 0,                "group_full_name":"某团队/一级组/二级组/三级组",                "group_id":67            }        ]    },    "request_id": "d84e884b-3bc5-419d-9cc0-d6d6d14e68b6"}

• 请求失败

{    "code": "PermissionDenied",    "error": {        "type": "claim_error"    },    "data": {},    "request_id": "5ffeb778-6046-42b2-b6f7-0c79ebc82288"}

错误码

error.type 错误代码	错误描述
invalid_argument	参数错误
claim_error	无权限